O que faz
YAML é popular em arquivos de configuração — manifestos do Kubernetes, workflows do GitHub Actions e do GitLab CI, Docker Compose, playbooks do Ansible, documentos OpenAPI — porque é fácil de ler. Também é fácil de quebrar: uma indentação errada, um tab, uma aspa não fechada ou a falta de espaço depois dos dois-pontos podem mudar o significado de um arquivo ou impedir que ele carregue.
Este validador analisa o seu YAML e aponta cada erro de sintaxe com linha e coluna, além de avisos como diretivas desconhecidas. Quando o YAML é válido, mostra o número de documentos e o tipo de cada valor raiz, e pode exibir uma cópia reformatada com indentação consistente.
Como usar
- Cole o YAML na entrada, envie um arquivo
.yamlou.yml, ou clique em Exemplo. - O resultado aparece enquanto você digita: um selo verde YAML válido ou uma lista de erros como
Linha 3, coluna 2. - Mantenha Mostrar YAML formatado ativado para obter uma cópia organizada e escolha 2 ou 4 espaços de indentação. Copie com o botão acima do bloco.
- Desative Chaves duplicadas são erro apenas se as suas ferramentas permitirem chaves repetidas.
Erros comuns
server:
port: 8080
host: localhost # indented one space too far
tags: [web, api # missing closing bracket
- Indentação inconsistente: itens do mesmo nível precisam começar na mesma coluna. YAML não permite tabs na indentação.
- Falta de espaço após os dois-pontos:
key:valueé uma string simples, não uma chave e um valor. - Caracteres especiais sem aspas: valores que começam com
*,&,!,%,@ou crase, ou que contêm:ou#, precisam de aspas. - Tipos inesperados:
yes,no,oneoffsão strings no YAML 1.2, mas booleanos em parsers antigos de YAML 1.1; use aspas por segurança. Números de versão como1.10viram o número 1.1 sem aspas.
Validar a estrutura
Esta ferramenta verifica a sintaxe: se o texto é um YAML bem formado. Para conferir se um arquivo tem as chaves e os tipos certos, converta-o com a ferramenta YAML para JSON e valide o resultado com o Validador de JSON Schema.
Perguntas frequentes
› Qual versão de YAML o validador segue?
YAML 1.2, a versão atual usada pela maioria das ferramentas modernas. Entradas com vários documentos separados por --- são verificadas documento por documento.
› Por que chaves duplicadas são apontadas como erro?
A especificação YAML exige que as chaves de um mapa sejam únicas, e muitos parsers mantêm em silêncio apenas o último valor, escondendo erros. Se a sua ferramenta aceita duplicatas de propósito, desative Chaves duplicadas são erro.
› A formatação mantém meus comentários?
Sim. Comentários, ordem das chaves, âncoras e strings entre aspas são preservados; só a indentação e os espaços são normalizados. Strings longas não são quebradas.
› Meu YAML é enviado para algum lugar?
Não. A análise acontece no seu navegador, então arquivos de configuração com segredos nunca saem do seu computador.