O que é Conversor de JSON para YAML?

O Conversor de JSON para YAML transforma dados JSON em formato YAML limpo, mais legível por humanos e amplamente usado em arquivos de configuração (Docker Compose, Kubernetes, pipelines de CI/CD). Ele trata objetos aninhados, arrays e strings multilinha com a sintaxe YAML adequada.

O conversor usa js-yaml por baixo dos panos e lida com strings multilinha, âncoras e arrays de objetos sem perder estrutura. A indentação pode ser de 2 ou 4 espaços (a maioria dos arquivos de config usa 2). O estilo flow mantém arrays curtos em uma linha ([a, b, c]); o block escreve um item por linha. Também há a opção 'ordenar chaves' para saída estável no controle de versão.

Como usar

1. Passo 1 — Cole seus dados JSON ou faça o upload de um arquivo .json. JSON inválido é capturado e destacado antes da conversão.
2. Passo 2 — Defina a largura do recuo (2 ou 4 espaços) e escolha opções de estilo de fluxo para arrays compactos ou objetos inline.
3. Passo 3 — Visualize a saída YAML com destaque de sintaxe, depois copie ou baixe como arquivo .yaml para uso nos seus arquivos de configuração.

Quando usar

• Traduzir um trecho de package.json ou tsconfig.json para o YAML que uma ferramenta de CI espera.
• Escrever manifestos Kubernetes ou arquivos Docker Compose a partir de respostas de API ou JSON gerado por scaffold.
• Migrar a configuração JSON de uma ferramenta antiga para um YAML mais legível na versão atualizada.

Resultado

Você está convertendo um package.json em uma configuração YAML para um pipeline de CI. Cole o JSON, defina recuo de 2 espaços e obtenha uma saída YAML limpa onde as dependências aninhadas ficam claramente visíveis sem todas as chaves e aspas.

Perguntas frequentes

YAML é só JSON com sintaxe diferente?

Mais ou menos. O YAML 1.2 é um superset do JSON: todo JSON válido também é YAML válido. O YAML adiciona comentários, strings multilinha, âncoras/aliases e layout baseado em indentação. Para dados puros, são intercambiáveis.

Devo usar 2 ou 4 espaços de indentação?

A convenção em Kubernetes, Docker Compose, GitHub Actions e na maioria das ferramentas de CI é 2 espaços. 4 ajuda em arquivos bem aninhados, mas é raro. Combine com os arquivos do seu time para os diffs ficarem limpos.

Quando faz sentido mudar para o estilo flow?

O estilo flow ({a: 1, b: 2}) cai bem em arrays curtos de primitivos, tipo uma lista de portas, que no estilo block ficam barulhentos um por linha. Para qualquer coisa que humanos vão ler ou editar à mão, mantenha o block.

O que acontece com strings que parecem booleans ou números?

A coerção de tipos do YAML é agressiva: 'yes', 'no', 'on', '1.0', 'null' acabam reinterpretados. O conversor coloca essas strings entre aspas para que sigam sendo strings, evitando o famoso bug 'Noruega' em que o código NO vira false.

Dá para converter de JSON para YAML e voltar sem perder nada?

Para dados puros, sim, a estrutura se preserva. Perde-se comentários (JSON não tem) e às vezes a ordem das chaves, porque o parser JSON pode reordenar. Para manter a ordem, ative 'ordenar chaves' dos dois lados.

Ferramentas relacionadas