Formatador de YAML
Formate YAML com uma largura de indentação consistente ou converta-o para JSON. Detecta tabulações misturadas e inconsistências de indentação.
Dicas
- Esta ferramenta usa um analisador leve desenvolvido internamente, com suporte a pares chave: valor, aninhamento, listas e a sintaxe em linha
[a, b, c]/{a: 1}. - Mesmo que você cole um YAML com indentação inconsistente (por exemplo, 3 ou 5 espaços), ele será reescrito com uma indentação uniforme de 2 ou 4 espaços, desde que seja analisado com sucesso.
- No modo "Converter para JSON" você pode visualizar o seu YAML convertido diretamente para JSON, útil para comparar com configurações de CI ou respostas de API.
- Se aparecer um erro, o número da linha é exibido, então verifique essa linha em busca de problemas de indentação ou um espaço faltando após os dois-pontos.
- O YAML proíbe indentação com tabulações. Ativar "converter tabulações em espaços" nas configurações do seu editor ajuda a evitar completamente esse problema.
Perguntas frequentes
|/>).no, yes, on ou off sem aspas é interpretado como booleano por muitas implementações de YAML, em vez de uma string comum (como o código do país da Noruega). Se quiser que seja tratado como string, use aspas, por exemplo "no".
Curiosidade — Por que o YAML se tornou o formato de configuração preferido
YAML (YAML Ain't Markup Language) é um formato de serialização de dados que surgiu em 2001. Como não exige tags de fechamento e parece muito mais simples que o XML, tornou-se a escolha padrão para arquivos de configuração de infraestrutura desde os anos 2010 — Docker Compose, GitHub Actions e manifestos do Kubernetes o utilizam.
Ainda assim, o design do YAML de "estrutura por indentação" é fácil de ler para humanos, mas também frágil: a indentação se quebra facilmente ao copiar e colar. Em particular, misturar tabulações e espaços pode fazer com que muitos analisadores produzam silenciosamente uma estrutura errada sem gerar erro algum, o que se torna uma fonte comum de erros de configuração não intencionais.
Há também uma armadilha bem conhecida chamada "problema da Noruega". Escrever o código do país no sem aspas é interpretado como o booleano false por muitas implementações de YAML. As diferenças entre YAML 1.1 e 1.2 sobre quais strings contam como booleanos também são uma fonte frequente de problemas de compatibilidade entre implementações.