Conversor YAML ⇄ JSON

O que o YAML ⇄ JSON faz

O YAML ⇄ JSON converte configurações estruturadas entre o YAML, baseado em indentação, e o JSON estrito. É útil ao mover exemplos entre manifestos do Kubernetes, arquivos de CI, configurações de sites estáticos, fixtures de API, metadados de pacotes, trechos de documentação e configurações de aplicações. O sentido de YAML para JSON analisa o YAML e gera JSON formatado com indentação de dois espaços. O sentido de JSON para YAML analisa JSON estrito e escreve um YAML legível, que pode ser colado em arquivos de configuração ou rascunhos de documentação. Os erros de validação aparecem imediatamente, o que ajuda a identificar erros de indentação, dois-pontos ausentes, aspas JSON inválidas, vírgulas sobrando e tabulações acidentais antes de você copiar um resultado quebrado.

A ferramenta mantém a origem e o resultado visíveis ao mesmo tempo, o que facilita conferir pequenas transformações. Ela foi pensada para o trabalho diário de desenvolvimento: verificar um exemplo de configuração durante uma revisão, preparar exemplos para a documentação, converter entre ferramentas que preferem formatos diferentes ou limpar uma fixture antes do commit. Ela não tenta interpretar esquemas específicos de projetos nem aplica valores padrão ocultos.

Fluxo de trabalho privado no navegador

Todo o processamento acontece no seu navegador, com JavaScript no lado do cliente. A ferramenta não envia trechos, valores de configuração, dados gerados, textos de consultas nem exemplos copiados para nenhum servidor e não exige conta. Esse modelo exclusivamente local é importante em utilitários para desenvolvedores, porque o conteúdo colado neles costuma parecer dados reais de aplicações: respostas de API, logs, exemplos no formato de variáveis de ambiente, consultas de banco de dados, marcação de rascunhos ou valores copiados em sessões de depuração em produção. Manter a transformação local reduz riscos e deixa a interação rápida, pois não há ida e volta pela rede.

A interface é propositalmente compacta para que você cole a entrada, ajuste as opções, confira o resultado, copie e volte ao seu editor. Ainda assim, revise os resultados antes de fazer commit, compartilhá-los publicamente ou usá-los em um fluxo de produção. Ferramentas de navegador são excelentes para inspeção e preparação rápidas, mas não conhecem todas as convenções de um projeto, regras de classificação de dados ou requisitos de validação específicos de uma aplicação.

Dicas práticas

Revise YAML complexo antes de confiar nele, porque o YAML oferece recursos que não correspondem perfeitamente ao JSON, como tags personalizadas, datas, aliases, chaves de mesclagem e valores que podem ser interpretados como booleanos ou números. O JSON tem um modelo de dados menor, então o uso mais seguro é com objetos, arrays, strings, números, booleanos e valores null comuns. Ao converter configurações para produção, valide o arquivo final com a ferramenta que vai consumi-lo. Se houver segredos na sua entrada, remova-os antes de copiar exemplos para outro lugar, mesmo que esta página faça a conversão localmente.