Conversor de JSON ⇄ YAML

Como funciona

O conversor funciona nos dois sentidos: de JSON para YAML usa o JSON.parse nativo e serializa com js-yaml, e de YAML para JSON faz o inverso. A conversão roda sozinha enquanto você digita (com atraso de um quarto de segundo), e um erro de sintaxe em qualquer direção mostra a mensagem do parser em uma linha vermelha e limpa a saída.

Por que YAML

YAML é a língua dos arquivos de configuração: manifests do Kubernetes, workflows do GitHub Actions, playbooks do Ansible. O estilo de bloco é muito mais legível que o JSON equivalente: sem chaves, sem vírgulas, e chaves e comentários podem ficar no nível superior do documento. Comentários são permitidos em YAML mas não existem em JSON, e por isso nunca sobrevivem a uma conversão.

Opções de exportação

A saída de JSON para YAML usa recuo de 2 espaços, estilo de bloco para sequências e mappings, sem âncoras nem aliases (o padrão do js-yaml), e strings só ganham aspas quando necessário — texto simples como hello fica sem aspas.

Ordem das chaves

A ordem das chaves é preservada ao exportar para YAML: o js-yaml emite as propriedades na ordem em que aparecem no documento de origem, que é também a ordem em que o JSON.parse as guarda no objeto.

O que se perde

Os comentários são descartados nos dois sentidos (o JSON não pode carregá-los e o parser descarta os do YAML). Arquivos YAML com vários documentos separados por --- não são suportados: esta ferramenta lê um único documento, então divida o fluxo e converta cada parte separadamente. Chaves duplicadas em JSON ficam com o último valor, como o formato exige.

Textos parecidos com data

O YAML 1.1 resolvia historicamente valores como 2024-01-01 para objetos de data nativos. O parser daqui segue o schema core moderno: valores com cara de data são carregados como texto simples e exportados entre aspas (‘2024-01-01’), então sobrevivem à ida e volta como string e nunca viram timestamp silenciosamente.

Perguntas frequentes