IA no seu dispositivo — profissional e privado.

Documentos

Como converter JSON em YAML e YAML em JSON (sem estragar seus valores)

Converta JSON em YAML ou YAML em JSON para Kubernetes, Docker Compose e CI. Conheça o problema da Noruega, as armadilhas de tabs e indentação e o que se perde.

Atualizado em 7 de novembro de 202610 min de leitura

Para converter JSON em YAML, cole o JSON no conversor de JSON para YAML, escolha o analisador para o qual seu YAML se destina e clique em Converter para YAML. Para fazer o caminho inverso, cole o YAML no conversor de YAML para JSON. Os dois levam segundos. O que vale a pena ler é o que pode dar errado: o YAML adivinha o tipo de palavras sem aspas, então um código de país como no pode virar false, uma permissão de arquivo pode virar outro número e uma data pode deixar de ser texto. Este guia cobre as duas direções, essas armadilhas e o que se perde pelo caminho.

Duas direções, duas ferramentas

JSON e YAML descrevem os mesmos tipos de dados: objetos, listas, texto, números, verdadeiro ou falso e null. O JSON é rígido e barulhento, com chaves, colchetes e aspas por toda parte. O YAML elimina quase tudo isso e usa a indentação no lugar, e é por isso que as pessoas o preferem para arquivos editados à mão. Cada direção tem sua própria ferramenta, com seus próprios limites.

Você temVocê querFerramentaLimite gratuito
JSON, uma resposta de API ou uma exportaçãoYAMLJSON para YAMLUm arquivo de até 10 MB
Uma configuração ou um manifesto YAMLJSONYAML para JSONUm arquivo de até 25 MB
JSON que não é analisadoJSON corrigidoValidador de JSONVeja a página da ferramenta
JSON bagunçado em uma única linhaJSON legívelFormatador de JSONVeja a página da ferramenta

Os limites diferem porque o trabalho difere. Converter JSON em YAML exige manter o documento inteiro como objetos vivos enquanto o YAML é escrito, e por isso essa ferramenta para em 10 MB. Ler YAML percorre o texto, então há espaço até 25 MB.

Convertendo JSON em YAML, passo a passo

1

Adicione seu JSON

Abra o conversor de JSON para YAML. Cole o JSON no editor e clique em Usar este JSON, ou solte um arquivo .json, .ndjson ou .jsonl na página.

2

Escolha o Analisador de destino

O padrão é Portável, que coloca entre aspas todo valor que um leitor YAML antigo ou que reconhece datas leria como outro tipo. O YAML 1.2 usa aspas só no que um analisador moderno precisa. Tudo entre aspas envolve cada texto em aspas quando você não sabe o que vai ler o arquivo.

3

Defina o layout

Escolha uma Indentação de 1 a 8 espaços (2 é o padrão), um Estilo de null entre null, ~ ou vazio e se o arquivo começa com ---.

4

Converta e leia o selo

Clique em Converter para YAML. Com Verificar o resultado ligado, o YAML é lido de volta por um analisador independente e comparado com o seu JSON. O selo diz Verificado, ou nomeia o primeiro caminho em que um valor voltou diferente.

5

Baixe ou copie

Use Baixar YAML ou Copiar. A prévia mostra as primeiras linhas em arquivos grandes, mas o download traz o resultado completo.

Convertendo YAML em JSON

Cole YAML no conversor de YAML para JSON ou solte um arquivo .yaml ou .yml. Os botões de exemplo de Kubernetes, Docker Compose e GitHub Actions carregam um arquivo típico para você ver o resultado primeiro. Todas as configurações de saída são gratuitas:

  • Indentação: 2 espaços, 4 espaços, Tabulações ou Minificado (uma linha, sem espaços em branco).
  • Documentos: Automático (um documento vira objeto, vários viram um array), Sempre array, Só o primeiro ou Arquivos separados, um .json por documento.
  • Ordenar chaves: coloca as chaves de cada objeto em uma ordem estável para que duas conversões sejam comparadas sem ruído.
  • Chaves duplicadas: Recusar, que indica a linha, ou Manter a última.
  • NaN e Infinity: Escrever null, Como texto ou Parar. O JSON não tem valor para .nan nem .inf.
  • Carimbos de data: Como escritos, ou ISO 8601.

Âncoras e aliases são expandidos onde são usados, e chaves de mesclagem como <<: *common são resolvidas, com as chaves escritas diretamente no mapa prevalecendo sobre as mescladas. Tags como !Ref são reduzidas ao valor que está por baixo, e os nomes das tags são listados abaixo do resultado.

Escolha o analisador, converta e receba um resultado verificado. Grátis: um arquivo de até 10 MB, com todas as configurações que afetam a correção incluídas. Pro: até 50 arquivos em um ZIP, mais estilos de saída. Tudo roda no seu aparelho, não em nossos servidores.

Converter JSON em YAML

O problema da Noruega e outras mudanças de tipo silenciosas

No YAML 1.1, a versão que PyYAML, Ansible e o Psych do Ruby ainda usam, as palavras simples yes, no, on, off, y e n são booleanos. Uma lista de códigos de país contendo NO (Noruega) volta, portanto, com false no lugar. Nenhum erro é avisado; os dados simplesmente ficam errados. O YAML 1.2 removeu essa regra, de modo que alguns analisadores leem o mesmo arquivo de forma diferente de outros. Essa discordância é a razão de existir da configuração Analisador de destino.

Valor no seu JSONO que um leitor YAML antigo pode fazer com eleDestino Portável
"no", "yes", "on", "off"Booleanos: "no" vira falseEntre aspas
"0755"Um número octal, 493Entre aspas
"1:30"Um número na base 60, 90Entre aspas
"2024-01-01"Um objeto de data, não textoEntre aspas
"true", "null", "12"Um booleano, null ou um número, em qualquer versão do YAMLEntre aspas (em todos os modos)
"hello"TextoSem aspas

O Portável usa aspas exatamente nos valores dessa tabela e deixa as palavras comuns em paz, então o arquivo continua legível. O modo YAML 1.2 usa menos aspas e só é correto se o que lê o arquivo for um analisador 1.2 sem tratamento de datas; mesmo assim, a ferramenta conta quantos valores um leitor antigo mudaria e avisa você. As chaves seguem as mesmas regras, porque uma chave n ou yes sem aspas vira booleana em um leitor 1.1. No sentido contrário, o YAML para JSON segue as regras do YAML 1.2: yes, no, on e off continuam sendo textos, e um carimbo de data como 2001-12-14 continua sendo o texto que você digitou, a menos que escolha ISO 8601.

Indentação, tabs e valores vazios

A estrutura do YAML é a indentação. Dois espaços a mais significam um filho; a mesma indentação significa um irmão. Uma única linha com um espaço a mais muda a forma dos dados ou interrompe a análise. As tabs são a falha clássica: o YAML as proíbe na indentação, e um arquivo que parece alinhado em um editor com paradas de tabulação pode se recusar a carregar. O conversor de YAML para JSON informa a linha e a coluna da falha, com algumas linhas do seu próprio texto e um marcador embaixo. Troque a tab por espaços e converta de novo.

O JSON para YAML não tem esse risco, porque a ferramenta escreve a indentação para você. Contêineres vazios são escritos como {} e [] em vez de ficarem em branco, porque um valor em branco é lido de volta como null. Texto com quebras de linha vira um bloco | legível, de modo que um script ou certificado mantém suas linhas. Se um bloco não consegue representar o texto com exatidão, por exemplo quando a primeira linha está em branco ou indentada, ou há um retorno de carro, o texto é colocado entre aspas. Mudanças silenciosas são piores do que uma saída feia.

O que se perde ao ir para JSON: comentários e nós compartilhados

O JSON não tem comentários. Quando você converte YAML em JSON, todo comentário com # é descartado, e com ele a documentação que carregava. Mantenha o YAML como fonte da verdade e trate o JSON como um resultado de build. Ao ir de JSON para YAML, você ganha a possibilidade de escrever comentários, mas começa sem nenhum, então adicione-os depois de converter.

Os aliases também são achatados. Dois lugares que se referiam a uma mesma âncora viram duas cópias idênticas no JSON, porque o JSON não consegue dizer que eram o mesmo nó. Converter de volta dá um YAML mais longo que o original. Um alias circular, em que uma âncora se refere a si mesma, é YAML legal mas impossível em JSON, e o conversor o informa com o caminho em vez de falhar em silêncio.

Usos típicos: Kubernetes, Docker Compose e arquivos de CI

  • Kubernetes: um manifesto separado por --- tem vários documentos. Use Automático ou Sempre array para obtê-los como JSON para uma ferramenta que o espera, ou Arquivos separados para um .json cada. Indo para YAML, defina o layout e confira o selo, porque um rótulo de versão como "1.20" precisa continuar texto.
  • Docker Compose: um serviço definido com <<: *common sai com as chaves compartilhadas já mescladas. Mapeamentos de porta como "22:22" são a armadilha da versão 1.1 na prática, já que um 22:22 sem aspas pode ser lido como número na base 60. O Portável coloca aspas.
  • Arquivos de CI como fluxos do GitHub Actions: a chave on continua sendo o texto "on", e não true. É a leitura certa para um analisador 1.2. Para comparar dois arquivos de fluxo, converta ambos com Ordenar chaves ligado; muda a ordem, não o significado.
  • Cargas de API: transforme uma resposta JSON em uma configuração YAML inicial, ou um arquivo de configurações YAML em corpo de requisição para um serviço que não lê YAML.

Para ver como duas configurações diferem, converta as duas, ordene as chaves e compare o JSON; mudanças de ordem e de comentários deixam de aparecer como diferenças. Para arrumar o JSON antes, veja como formatar JSON online e, para fontes XML, converter XML em JSON.

Quando a conversão falha

Se o JSON não puder ser analisado, o conversor mostra a linha e a coluna, um marcador sob o caractere exato e o que era esperado ali. As causas comuns são uma vírgula sobrando no fim, aspas simples em vez de duplas, um comentário ou uma chave sem aspas. O Validador de JSON lista as falhas de uma só vez, e o Formatador de JSON deixa a estrutura mais fácil de ver. Corrija a sintaxe e converta de novo.

  • Arquivo grande demais: os limites gratuitos são 10 MB para JSON para YAML e 25 MB para YAML para JSON. Divida o arquivo ou use o Pro.
  • Vários arquivos de uma vez: o Grátis converte um por vez. O Pro enfileira até 50 e baixa tudo em um único ZIP; o YAML para JSON também pode juntar todos os documentos de todos os arquivos em um só array.
  • Chaves duplicadas no YAML: o padrão é recusar e nomear a segunda chave. O JSON não pode guardar as duas, então escolha Manter a última só quando souber qual valor quer.
  • Um valor diferente após converter: a mensagem Verificação falhou indica o caminho e os dois tipos, por exemplo um texto que voltou como data. Mude o Analisador de destino para Portável.

Perguntas frequentes

Como converto JSON em YAML?

Cole seu JSON no conversor de JSON para YAML, escolha um Analisador de destino (Portável é o padrão) e clique em Converter para YAML. Depois baixe o arquivo .yaml ou copie. O plano grátis aceita um arquivo de até 10 MB.

Como converto YAML em JSON?

Cole YAML ou solte um arquivo .yaml ou .yml no conversor de YAML para JSON. Escolha a indentação, como tratar vários documentos e se as chaves serão ordenadas, e baixe o resultado. O plano grátis aceita um arquivo de até 25 MB.

O que é o problema da Noruega no YAML?

No YAML 1.1, a palavra no sem aspas é um booleano, então o código de país NO da Noruega é lido como false. Colocar o valor entre aspas resolve. O conversor de JSON para YAML faz isso por você quando o Analisador de destino é Portável.

Os comentários são mantidos ao converter YAML em JSON?

Não. O JSON não tem comentários, então todo comentário com # é descartado. Mantenha o YAML como fonte e gere o JSON a partir dele, em vez de editar o JSON à mão.

Por que meu YAML falha com um erro de tab?

O YAML não permite tabs na indentação, mesmo que o arquivo pareça alinhado no seu editor. Troque as tabs por espaços. O conversor de YAML para JSON informa a linha e a coluna em que parou.

Posso converter arquivos do Kubernetes ou do Docker Compose?

Sim. Um manifesto com vários documentos separados por --- vira um array, o primeiro documento ou um arquivo por documento. Âncoras, aliases e chaves de mesclagem são resolvidos. Tudo roda no seu aparelho, não em nossos servidores, então nomes de host e de imagens não são enviados.

Continue lendo

Mais sobre Documentos →