Converta YAML em JSON!

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

Converta YAML em JSON!

Converte um documento YAML (yml) em JSON para você ver a estrutura que a indentação esconde e o tipo real com que cada valor foi lido. Anchors e aliases são expandidos em valores reais, e vários documentos separados por --- são reunidos num array.

É especialmente útil para pegar erros clássicos de YAML: um valor preso ao pai errado por causa de um espaço a menos, ou version: 1.10 virando silenciosamente o número 1.1.

Como usar

  1. Cole um docker-compose.yml, um manifest do Kubernetes ou um arquivo de workflow na caixa YAML, ou solte o arquivo nela.
  2. Erros de sintaxe aparecem no resultado com número de linha e coluna; confira primeiro a indentação nesse ponto.
  3. Leia o JSON em Resultado para ver se cada valor virou string, número ou booleano, e copie se precisar.

Exemplo

Entrada (YAML)
name: ci
on:
  push:
    branches: [main]
defaults: &node
  runs-on: ubuntu-latest
  timeout-minutes: 10
jobs:
  test: *node
Saída (JSON)
{
  "name": "ci",
  "on": {
    "push": {
      "branches": [
        "main"
      ]
    }
  },
  "defaults": {
    "runs-on": "ubuntu-latest",
    "timeout-minutes": 10
  },
  "jobs": {
    "test": {
      "runs-on": "ubuntu-latest",
      "timeout-minutes": 10
    }
  }
}

A chave on: do GitHub Actions continua sendo a chave string "on", porque esta ferramenta faz o parse com as regras do YAML 1.2. O bloco definido com o anchor &node é expandido no lugar de *node.

Recursos suportados

  • Parse com o core schema do YAML 1.2: yes, on e off continuam strings, e só true/True/false viram booleanos.
  • ~ e valores vazios viram null; hexadecimal 0x1F e octal 0o17 viram números.
  • &anchors e *aliases são resolvidos para os valores referenciados.
  • Block scalars literais | e dobrados > viram strings com as regras de quebra de linha do YAML aplicadas.
  • Vários documentos separados por --- viram um array JSON; um documento único sai como o seu próprio valor.
  • Uma chave que aparece duas vezes no mesmo mapping é reportada como erro.

Casos de uso

Conferir a indentação de manifests do Kubernetes

Se o env dentro de containers está indentado um nível a menos, ele se prende silenciosamente a outro campo e você só descobre na hora do apply. Em JSON, as chaves mostram exatamente a qual objeto ele pertence.

Usar configuração a partir do código

Para um script ou um bundle front-end em que adicionar um parser YAML é exagero, converta a configuração uma vez e use como import config from './config.json'.

Inspecionar uma spec OpenAPI

Um documento OpenAPI escrito em YAML fica mais fácil de consultar com JSONPath ou jq depois de convertido, por exemplo para extrair o schema de um path específico.

Observações e limitações

  • Merge keys (<<: *defaults) são aplicadas: as chaves do mapping com anchor são copiadas, e as chaves escritas ao lado do << as sobrescrevem. Um parser só YAML 1.2 manteria << como chave comum, então os resultados podem diferir dessas ferramentas.
  • Datas e horas como 2024-01-01 continuam strings em vez de virarem valores Date.
  • .inf e .nan não têm representação em JSON e viram null.
  • Comentários não podem ser levados para o JSON e são descartados.
  • O PyYAML (YAML 1.1) lê on e yes como true, então resultados vindos do Python podem diferir.

Perguntas frequentes

Por que o on do GitHub Actions aparece como "on" e não como true?

No YAML 1.2, os únicos booleanos são true e false, então on é uma string comum, que é também como o GitHub Actions lê a chave. O PyYAML do Python segue o 1.1 e a transforma numa chave True, então tome cuidado ao fazer parse de workflows em scripts.

version: 1.10 sai como 1.1.

1.10 sem aspas é um número em YAML, e 1.10 é igual a 1.1. Para manter uma string de versão, coloque aspas no YAML de origem: "1.10".

O que acontece com um arquivo com vários documentos?

Cada documento separado por --- vira um elemento do array, em ordem, então um arquivo com vários recursos usado com kubectl apply -f gera um array de recursos.