JSON to YAML Converter
Convert JSON structure to clean YAML format. Ideal for Kubernetes manifests and cloud configs.
Convert JSON structure to clean YAML format. Ideal for Kubernetes manifests and cloud configs.
Passar de JSON para YAML consiste principalmente em tornar os dados mais legíveis para humanos. Ambos os formatos descrevem os mesmos tipos de estruturas — objetos/mapas, matrizes/sequências, escalares — mas a sintaxe baseada em indentação do YAML, citações opcionais e suporte para comentários facilitam a digitalização e a edição manual. Os arquivos de configuração são o caso de uso canônico: manifestos do Kubernetes, fluxos de trabalho de CI, manuais Ansible e dezenas de outras ferramentas escolheram YAML especificamente porque seus editores principais são humanos.
Este conversor usa js-yaml para serializar um objeto JSON analisado em YAML. O resultado preserva exatamente a estrutura dos dados ao aplicar convenções YAML: recuo para aninhamento, listas para matrizes, pares chave-valor para propriedades de objetos. As aspas duplas estritas do JSON são relaxadas; apenas strings contendo caracteres especiais ou que se pareçam com outros tipos são citadas na saída.
A conversão preserva informações, exceto onde o YAML adiciona expressividade que o JSON não tinha. Os comentários não podem ser reconstruídos (o JSON não tinha nenhum). As referências de âncora e de alias podem compactar estruturas repetidas, mas não são geradas automaticamente; a saída expande todas as referências embutidas.
YAML é dramaticamente mais legível do que JSON para configuração de edição humana. O recuo substitui o aninhamento de chaves, as aspas são opcionais para strings simples e os comentários podem documentar configurações não óbvias. Para arquivos mantidos por humanos – configuração de aplicativos, infraestrutura como código, pipelines de construção – YAML é quase sempre o formato de destino correto.
As ferramentas de infraestrutura modernas favorecem esmagadoramente o YAML. Kubernetes, gráficos Helm, Ansible, GitHub Actions, GitLab CI, Docker Compose e muitas outras ferramentas preferem ou exigem YAML. Converter exportações JSON de um sistema em configuração YAML para outro é uma etapa rotineira de integração.
Cole JSON, obtenha YAML.
A função dump do js-yaml percorre a árvore de objetos JavaScript e emite YAML usando formatação configurável. Profundidade de recuo, largura da linha, limite de estilo de fluxo e tratamento de cotação são todos parâmetros. As configurações padrão produzem YAML em estilo de bloco com recuo de 2 espaços, a convenção mais comum.
A citação de strings segue as regras do YAML: strings que se parecem com outros tipos (números, booleanos, nulos, datas) são citadas para forçar a interpretação da string; strings contendo caracteres especiais (dois pontos, hashes, travessões iniciais) são citadas; cadeias alfabéticas simples são deixadas sem aspas.
A saída é compatível com YAML 1.2 e analisa de forma limpa com js-yaml, PyYAML e outras bibliotecas YAML importantes. As viagens de ida e volta idempotentes (JSON → YAML → JSON) preservam os dados, embora a representação YAML escolha uma formatação canônica que pode diferir de um equivalente escrito à mão.