Validador YAML
Valida sintaxe YAML e visualiza resultados.
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
- Cole ou digite o seu documento no campo YAML.
- Leia a linha de status abaixo dele:
Valid YAMLem caso de sucesso, ou a mensagem de erro do parser — incluindo a linha e a coluna do problema — em caso de falha. - 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.