Pular para o conteúdo
FileTinker

Conversor JSON ⇄ YAML

Converta entre JSON e YAML nos dois sentidos — cole um e obtenha o outro instantaneamente. Útil para arquivos de configuração, manifestos do Kubernetes e payloads de API. Tudo roda no seu navegador, então seus dados nunca são enviados.

O resultado aparecerá aqui.

Mais predefinições

Vá para outra predefinição — cada uma abre na própria página, pronta para usar:

Como converter JSON e YAML

  1. Escolha o sentido — JSON → YAML ou YAML → JSON.
  2. Cole o seu documento na caixa de entrada.
  3. Copie o resultado convertido da caixa de saída.

Sobre JSON e YAML

JSON e YAML descrevem os mesmos tipos de dados estruturados — objetos, arrays e escalares — em estilos diferentes. JSON usa chaves e aspas e é a língua franca das APIs web; YAML usa indentação, é menos verboso e é a escolha habitual para configuração editada por humanos, como manifestos do Kubernetes, GitHub Actions e Docker Compose.

Converter entre eles permite que você leia uma resposta de API como YAML ou transforme uma configuração YAML no JSON que um programa espera, sem reescrevê-la à mão. Este conversor analisa e re-serializa inteiramente no seu navegador, então suas configurações e payloads nunca saem do seu dispositivo.

O YAML gerado por esta ferramenta é propositalmente simples: utiliza o estilo de bloco expandido, sem âncoras ou aliases, de modo que as estruturas repetidas sejam escritas por completo, em vez de serem referenciadas. Isso garante que a saída seja legível para pessoas e para ferramentas que suportam apenas um subconjunto do YAML, além de tornar as diferenças (diffs) previsíveis. Ao fazer o processo inverso, lembre-se de que os comentários são perdidos — o JSON simplesmente não possui uma sintaxe para comentários —, portanto, mantenha o YAML original se os comentários forem importantes.

A conversão também é uma ferramenta rápida para auxiliar na depuração. Se uma configuração apresentar um comportamento estranho, convertê-la para JSON mostrará exatamente como um analisador a interpreta – cada tipo implícito, cada nível de aninhamento, tudo explicitado com colchetes e aspas. É uma maneira fácil de identificar um erro de indentação que moveu uma chave para o objeto errado, ou um valor sem aspas que não era a string que você esperava. Cole o arquivo suspeito e analise a estrutura, não os espaços em branco.

Perguntas frequentes

Como converter JSON para YAML?

Escolha o sentido JSON → YAML, cole o seu JSON e o YAML aparece instantaneamente. Mude a chave para converter no sentido YAML → JSON.

A conversão é sem perdas?

JSON é mapeado de forma limpa para YAML e de volta no caso de objetos, arrays, strings, números, booleanos e null. Recursos exclusivos do YAML, como comentários e âncoras, não são representados em JSON.

Por que converter entre eles?

YAML é mais fácil de ler e escrever para configuração (Kubernetes, CI, Docker Compose); JSON é o que a maioria das APIs e programas trocam. Converter permite que você trabalhe com o formato que melhor se adequa à tarefa.

Meus dados são enviados?

Não. A conversão acontece inteiramente no seu navegador; nada é enviado a um servidor.

Por que um valor YAML não delimitado por aspas se transformou em um valor booleano ou numérico em JSON?

YAML infere os tipos a partir de valores escalares não delimitados por aspas: "true" e "false" são convertidos em valores booleanos, dígitos isolados são convertidos em números e um único valor "null" (ou um valor vazio) é convertido em "null". A saída JSON torna essas inferências visíveis, incluindo as aspas em torno de qualquer valor que tenha sido interpretado como uma string. Se você desejar que um valor seja tratado como uma string literal — por exemplo, um número de versão como 1.10 —, coloque-o entre aspas no código YAML e converta-o novamente.