Conversor de JSON para YAML
Transforme arrays ou objetos JSON em YAML limpo e legível. Cole ou envie JSON, escolha o estilo de array em bloco ou em linha, a indentação e as regras de aspas, e copie ou baixe o resultado, tudo no seu navegador.
100% Processamento no Lado do Cliente
Seu JSON é analisado e convertido totalmente no seu navegador. Nada é enviado para um servidor.
Opções
Índice
O que é um conversor de JSON para YAML?
Um conversor de JSON para YAML pega dados JSON estruturados — um array de objetos ou um único objeto — e os reescreve como YAML ("YAML Ain't Markup Language"), o formato de dados baseado em indentação usado em manifestos do Kubernetes, arquivos do Docker Compose, pipelines de CI/CD (GitHub Actions, GitLab CI, CircleCI), playbooks do Ansible e inúmeros arquivos de configuração de aplicações.
O conversor percorre a estrutura JSON e mapeia cada chave para uma entrada de mapeamento YAML: chaves de objeto viram linhas "chave: valor", arrays viram itens de lista indentados (ou listas em linha), e strings recebem aspas automaticamente apenas quando necessário — produzindo YAML limpo e mínimo, fácil de ler e seguro de processar.
Como funciona
- Adicione seu JSON: cole o JSON diretamente no editor ou envie um arquivo .json.
- Escolha suas opções: defina o tamanho da indentação, se os arrays devem ser exibidos como listas em bloco ou como listas em linha, e se os valores de string devem ter aspas apenas quando necessário ou sempre.
- Veja o resultado instantaneamente: a ferramenta analisa seu JSON no navegador e mostra o YAML convertido enquanto você digita, junto com a contagem de linhas e caracteres.
- Copie ou baixe: copie o YAML para a área de transferência ou baixe-o como um arquivo .yaml.
Recursos
- Cole JSON ou envie um arquivo .json
- Conversão instantânea e ao vivo enquanto você digita, sem precisar clicar em nada
- Funciona com um único objeto JSON ou um array de objetos
- Estilo de array em bloco (- item por linha) ou em linha ([a, b, c])
- Aspas automáticas e inteligentes: strings só recebem aspas quando necessário (parecem números, são palavras reservadas ou têm caracteres especiais)
- Modo opcional "sempre usar aspas" para uma saída mais estrita e explícita
- Indentação configurável (2, 4 ou 8 espaços — YAML proíbe tabulações para indentação, então não há opção de tabulação)
- Aninha corretamente objetos dentro de arrays e arrays dentro de arrays
- Arrays e objetos vazios aparecem como [] e {} em vez de serem omitidos
- Contagem de linhas e caracteres em tempo real
- Processamento 100% no navegador para sua privacidade
Boas práticas
- Deixe as aspas em "Automático" a menos que tenha um motivo para mudar: o modo automático mantém o resultado legível e ainda coloca aspas com segurança em qualquer coisa ambígua, como uma string que parece um número, um booleano ou a palavra "null".
- Use o estilo em linha para listas curtas de valores simples: uma lista de tags ou IDs geralmente fica mais legível em uma única linha do que em vários itens em bloco — o estilo em linha só se aplica a arrays de valores simples e volta automaticamente ao estilo em bloco para arrays que contêm objetos ou arrays aninhados.
- Fique atento a strings que parecem números mas devem continuar sendo texto: valores como CEPs, ramais telefônicos ou IDs com zero à esquerda (por exemplo, "007") recebem aspas automaticamente para que um analisador YAML não os reinterprete como números.
- Verifique duas vezes chaves e valores que contêm dois-pontos: um valor como "Winner: Best Programmer" recebe aspas automaticamente, já que uma sequência de dois-pontos e espaço sem aspas seria lida como um mapeamento aninhado.
- Valide contra o dialeto YAML da sua ferramenta de destino: a maioria das ferramentas (Kubernetes, GitHub Actions, Docker Compose) aceita o YAML padrão 1.1/1.2 produzido aqui, mas sempre passe o resultado pelo validador ou modo de simulação do seu sistema de destino antes de confiar nele em produção.
Solução de problemas
Diz que meu JSON é inválido
Verifique se há uma vírgula sobrando após o último item de um array ou objeto, chaves sem aspas, aspas simples em vez de duplas, ou um colchete não fechado — essas são as causas mais comuns de falha ao analisar JSON.
Um valor de string saiu entre aspas quando eu não esperava
Isso é intencional e seguro: strings que parecem números, booleanos ou as palavras null/true/false/yes/no (em qualquer variação de maiúsculas/minúsculas) recebem aspas automaticamente para que um analisador YAML as leia como strings, não como esses tipos.
Meu array de objetos não virou uma lista em linha
O estilo em linha ([a, b, c]) só se aplica a arrays formados inteiramente por valores simples (strings, números, booleanos, null). Arrays que contêm objetos ou arrays aninhados sempre usam o estilo em bloco (multilinha), já que objetos em linha são muito mais difíceis de ler.
Não há opção de indentação com "tabulação"
A especificação do YAML não permite caracteres de tabulação literais para indentação — apenas espaços são válidos. Por isso esta ferramenta só oferece indentação de 2, 4 ou 8 espaços, não tabulação.
Casos de uso comuns
- Escrever manifestos do Kubernetes: converta um objeto JSON que descreve um Deployment, Service ou ConfigMap para o formato YAML esperado pelo kubectl.
- Gerar arquivos de pipeline de CI/CD: transforme uma configuração de pipeline definida em JSON no formato YAML exigido pelo GitHub Actions, GitLab CI ou CircleCI.
- Migrar configuração de aplicação: converta um arquivo de configuração JSON para YAML para ferramentas e frameworks (Docker Compose, Ansible, Spring Boot) que preferem ou exigem YAML.
- Documentar respostas de API em um formato mais legível: a ausência de colchetes e aspas na maioria dos valores torna o YAML mais fácil de ler em documentação do que o JSON puro.
- Testar código que consome YAML: gere rapidamente payloads YAML de exemplo a partir de fixtures de teste em JSON sem escrever YAML à mão.
Perguntas frequentes
Sim. Um único objeto vira diretamente um mapeamento YAML. Um array de nível superior vira uma sequência em bloco YAML, com cada item como uma entrada de lista.
O estilo em bloco escreve um item do array por linha com um traço à esquerda — o estilo YAML padrão e mais legível. O estilo em linha escreve o array em uma única linha entre colchetes, como [a, b, c] — mais compacto, mas usado aqui apenas para arrays de valores simples, nunca para arrays de objetos.
Com as aspas em "Automático" (padrão), uma string só recebe aspas quando deixá-la sem aspas mudaria seu significado — por exemplo, se parece um número ("007"), um booleano ("yes"), a palavra "null", ou contém dois-pontos seguido de um espaço. Strings comuns ficam sem aspas para melhor legibilidade.
Sim. Mude "Aspas em strings" para "Sempre usar aspas" para envolver cada valor de string em aspas duplas, precisando ou não.
Objetos aninhados viram mapeamentos YAML indentados. Arrays aninhados e arrays de objetos são indentados como sequências em bloco, com a primeira chave de cada objeto ficando na mesma linha do seu traço.
Não. Tudo acontece localmente no seu navegador, e nada é enviado ou salvo.
O conversor roda na memória do seu navegador, então arquivos JSON muito grandes (dezenas de megabytes ou mais) podem ficar lentos ou usar bastante memória, dependendo do seu dispositivo.