pressione ⌘K para trocar de ferramenta
VALIDATE & INSPECT

Validador YAML

Valida sintaxe YAML e visualiza resultados.

local
yaml-validator
§01 SOBRE ESTA FERRAMENTA

Visão geral

O YAML Validator confere a sintaxe YAML ao vivo conforme você digita e, quando o documento é válido, mostra a estrutura interpretada como JSON formatado. Ele usa o js-yaml, o mesmo parser presente em inúmeras toolchains Node.js, então os erros e a inferência de tipos batem com o que o seu pipeline de build vai fazer. Serve para depurar configurações de CI (GitHub Actions, GitLab CI), manifests do Kubernetes e arquivos do Docker Compose antes de commitá-los.

Como usar

  1. Cole ou digite o seu documento no campo YAML.
  2. Leia a linha de status abaixo dele: Valid YAML em caso de sucesso, ou a mensagem de erro do parser — incluindo a linha e a coluna do problema — em caso de falha.
  3. Quando estiver válido, revise o painel Parsed (as JSON) para confirmar a estrutura e os tipos inferidos.

Exemplos

Entrada:

server:
  host: localhost
  port: 8080

Parsed (as JSON): { "server": { "host": "localhost", "port": 8080 } } — note que port é um número, e não uma string.

Um caractere de tabulação usado como indentação produz um erro nomeando a linha problemática, já que o YAML proíbe tabulação na indentação.

Observações

O validador interpreta um único documento; streams com vários documentos separados por --- não são reportados por completo. A validação cobre apenas a sintaxe — ela não pode saber se as chaves são as corretas para a ferramenta que vai consumir o arquivo (isso exige um linter com consciência de schema para o formato específico).

Documentos cujas âncoras e aliases se referenciam de forma multiplicativa são recusados antes da análise. Algumas centenas de bytes de aliases aninhados podem se expandir para centenas de megabytes — 253 bytes chegando a 22,8 MB é fácil de montar — o que travaria a aba. O uso comum de âncoras, incluindo as chaves de merge <<: que aparecem por todo Docker Compose e configurações de CI, não é afetado. Entrada acima de 2 MB também é recusada.

FAQ
Meu YAML é enviado para um servidor?
Não. A análise roda no seu navegador com a biblioteca js-yaml; arquivos de configuração, segredos e definições de CI nunca saem da página.
Por que o resultado interpretado é mostrado como JSON?
O JSON deixa a estrutura interpretada sem ambiguidade. O YAML tem muitas formas de escrever os mesmos dados, então ver os objetos, arrays, strings e números resultantes em JSON confirma exatamente como um consumidor vai interpretar o seu documento.
Meu YAML é válido, mas um valor foi interpretado de forma diferente do que eu esperava. Por quê?
O YAML infere tipos de forma agressiva: um no sem aspas vira false em alguns schemas, 08 pode falhar como octal e 1.0 vira número. Coloque entre aspas os valores que você quer como texto e use a prévia em JSON para verificar os tipos inferidos.