Converta JSON em YAML!

Insira JSON para convertê-lo em YAML legível! Compatível com yml, Kubernetes, docker-compose, Spring application.yml.
JSON
Resultado
 

Converta JSON em YAML!

Transforma JSON em YAML baseado em indentação. As chaves e a maior parte das aspas somem, o que deixa o resultado mais fácil de manter à mão como arquivo de configuração, e a ordem das chaves fica exatamente como no JSON de origem.

Ajuda quando você leva para um manifest um recurso obtido com kubectl get -o json, ou cola configurações recebidas de uma API num docker-compose.yml, num application.yml ou num workflow do GitHub Actions.

Como usar

  1. Cole o JSON na caixa JSON. Sintaxe inválida mostra JSON parsing failed no resultado; se precisar, passe antes pelo validador de JSON.
  2. Revise o YAML em Resultado. A indentação é de dois espaços.
  3. Copie para o seu arquivo .yml, ajustando a profundidade da indentação se for aninhá-lo dentro de outro bloco.

Exemplo

Entrada (JSON)
{
  "services": {
    "web": {
      "image": "nginx:1.27",
      "ports": ["8080:80"],
      "environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
    }
  }
}
Saída (YAML)
services:
  web:
    image: nginx:1.27
    ports:
      - 8080:80
    environment:
      FEATURE_FLAG: "on"
      GREETING: |-
        hello
        world

A string "on" mantém as aspas: escrita sem aspas como on, um parser YAML 1.1 a leria como o booleano true. GREETING tem uma quebra de linha, então é emitido como um bloco |- que mostra cada linha como foi escrita.

Recursos suportados

  • As aspas seguem o YAML 1.1. Strings como yes, no, on, off, y, n, ~, null e parecidas como "0777", "1.0" ou "2024-01-01" ficam entre aspas para que o PyYAML (1.1) e os parsers 1.2 modernos leiam o mesmo valor.
  • Strings como 22:22, que o YAML 1.1 pode ler como número em base 60, também ficam entre aspas, evitando um bug clássico de mapeamento de portas no docker-compose.
  • Strings de várias linhas viram blocos literais |-.
  • Strings longas nunca são quebradas (sem limite de largura de linha).
  • Arrays e objetos vazios ficam como [] e {}.

Casos de uso

Da saída JSON do kubectl para um manifest

Converta um Deployment ou ConfigMap puxado do cluster como JSON, apague campos como status e metadata.uid, e você tem um manifest pronto para o Git.

Escrever o application.yml do Spring Boot

Um bloco de propriedades recebido como JSON de um config server ou da documentação vira uma hierarquia YAML, sem você precisar indentar à mão chaves como spring.datasource.url.

Observações e limitações

  • Não são gerados comentários, anchors (&) nem aliases (*); um objeto repetido no JSON se repete no YAML.
  • Inteiros acima de 9007199254740991 perdem precisão por causa do limite numérico do JavaScript; mantenha IDs longos como string no JSON.
  • A saída é um único documento. Para um arquivo com vários recursos separados por ---, converta cada recurso e junte você mesmo.

Perguntas frequentes

Por que algumas strings ficam entre aspas e outras não?

As aspas só são adicionadas onde um valor sem aspas seria lido como outro tipo. nginx:1.27 é string de qualquer jeito, mas on, 010 e 22:22 viram booleanos ou números em alguns parsers, então ganham aspas.

Posso aplicar a saída direto no Kubernetes?

A estrutura é válida como está. Mas a saída de kubectl get -o json traz campos preenchidos pelo servidor, como status, resourceVersion e managedFields, que é melhor remover antes de aplicar.

Dá para trocar para indentação de quatro espaços?

Não há opção; é fixo em dois espaços, a convenção usada em toda a documentação do Kubernetes, do docker-compose e do GitHub Actions.