Conversor de JSON para YAML

Transforme JSON em YAML legível em uma etapa.

Funciona no navegador. Nada do que você digita é enviado a lugar nenhum.

Como converter JSON para YAML

  1. Cole ou envie seu JSON.
  2. O YAML aparece enquanto você digita.
  3. Copie ou baixe o arquivo .yaml.

O que muda de JSON para YAML

  • Chaves e vírgulas desaparecem. A indentação mostra a estrutura no lugar delas.
  • Nomes de propriedade perdem as aspas, a menos que um nome contenha um caractere que o YAML precise colocar entre aspas, como dois-pontos.
  • Um array JSON vira uma lista de linhas com traço, uma por item, indentada sob a chave dele.
  • true, false e null são escritos com a mesma palavra nos dois formatos.

Por que alguns valores YAML mantêm as aspas

Valor JSONEscrito comoMotivo
"007"'007'007 sem aspas seria lido como o número 7
"yes"'yes'Alguns leitores YAML tratam yes ou no sem aspas como booleano
"null"'null'null sem aspas seria interpretado como o valor null
"2024-01-01"'2024-01-01'Datas sem aspas são lidas como um tipo data em alguns leitores

Onde o YAML aparece

  • Arquivos do Docker Compose
  • Manifests do Kubernetes
  • Arquivos de workflow do GitHub Actions
  • Playbooks do Ansible

Onde JSON para YAML ajuda

  • Transformar um arquivo de configurações exportado no formato que sua ferramenta de deploy realmente lê.
  • Deixar uma resposta de API mais fácil de examinar de relance antes de comparar duas versões dela.
  • Rascunhar um arquivo de valores para um chart do Helm ou ferramenta parecida a partir de dados JSON existentes.

Perguntas frequentes sobre JSON para YAML

Por que usar YAML em vez de JSON?

O YAML dispensa a maioria dos colchetes e aspas e usa indentação no lugar, então arquivos de configuração para ferramentas como Docker Compose, Kubernetes e GitHub Actions ficam mais fáceis de ler e editar à mão.

Por que alguns valores ficam entre aspas?

Strings que o YAML leria como outra coisa mantêm as aspas. Por exemplo, '007' continua texto em vez de virar o número 7, e 'yes' continua uma string.

Posso adicionar comentários ao YAML?

O JSON não tem comentários, então não há nenhum para carregar. Você pode adicionar os seus com um # depois de converter.

Qual dialeto de YAML isso escreve?

YAML 1.2 padrão, produzido pelo js-yaml, a mesma biblioteca que muitas ferramentas de build do Node.js usam para ler e escrever arquivos de configuração.

Ele mantém a ordem das chaves?

Sim. As chaves são escritas na mesma ordem em que aparecem no objeto JSON, então um diff entre os dois continua fácil de acompanhar.

Posso converter um array JSON no nível mais alto?

Sim. Um array no nível mais alto vira uma sequência YAML de itens com traço em vez de um mapeamento de chaves e valores.

Lida com objetos profundamente aninhados e arrays de objetos?

Sim. Aninhamento de qualquer profundidade converte corretamente, com cada nível indentado 2 espaços a mais que o pai, que é o estilo padrão do js-yaml.

O que acontece com um valor que contém dois-pontos, como um horário ou uma URL?

O valor inteiro fica entre aspas, já que dois-pontos sem aspas seguido de um espaço pareceria o início de uma nova chave.

Ferramentas relacionadas