Aprenda a transformar JSON em YAML, entender indentação, tipos e strings ambíguas e revisar o arquivo antes de usar em configuração.
Resumo: este guia explica o conceito, mostra como interpretar o resultado e aponta os limites da ferramenta antes de você aplicá-la em conteúdo real.
YAML é mais legível, mas sensível à indentação
Estruturas que usam chaves e colchetes em JSON podem aparecer de forma mais enxuta em YAML. Em compensação, espaços e níveis de indentação passam a ter significado estrutural.
JSON é compatível com o modelo básico de YAML
YAML 1.2 foi projetado para manter compatibilidade com JSON em grande parte dos casos, mas YAML oferece recursos adicionais como âncoras, tags e múltiplos estilos de string.
Strings podem parecer outros tipos
Valores como datas, números com zeros à esquerda e palavras especiais podem ser interpretados de modo diferente conforme parser e versão. Quando o valor precisa permanecer texto, aspas ajudam.
Arrays viram sequências
Listas JSON normalmente viram itens iniciados por hífen. Objetos dentro dessas listas preservam a hierarquia pela indentação.
Teste no parser real
Arquivos de configuração podem ser processados por bibliotecas com regras específicas. Sempre valide o YAML no sistema que irá consumi-lo.
Exemplo prático
O JSON {"porta":8080,"ativo":true} pode virar duas linhas YAML. Já um valor textual como "00123" merece atenção para não perder zeros em parsers que o tratem como número.
Erros comuns e como evitar
- misturar tabs e espaços.
- quebrar a indentação.
- assumir que toda string será interpretada como string.
- usar recursos avançados de YAML quando o sistema aceita apenas um subconjunto.
Revise o resultado final e confirme unidades, estrutura ou formato antes de reutilizar a saída em outro sistema.
Leitura relacionada
Dúvidas frequentes
YAML aceita JSON?
YAML 1.2 foi projetado com compatibilidade importante com JSON, mas os parsers e recursos usados podem variar.
Tabs podem ser usadas na indentação?
Evite tabs; espaços são a escolha segura para indentação estrutural.
Preciso colocar aspas em tudo?
Não, mas strings ambíguas podem precisar de aspas para preservar a interpretação desejada.
Fontes e referências
Documentação técnica e referências usadas para aprofundar este guia: