YAML para JSON

O que é a Conversão de YAML para JSON?

A conversão de YAML para JSON transforma dados escritos em YAML (YAML Ain't Markup Language) para JSON (JavaScript Object Notation). Ambos os formatos representam dados estruturados como pares chave-valor, sequências e objetos aninhados, mas diferem na sintaxe. YAML usa indentação e pontuação mínima, enquanto o JSON usa chaves, colchetes e aspas obrigatórias. Converter entre os dois é uma tarefa comum ao mover dados de configuração entre sistemas que esperam formatos diferentes.

O YAML foi projetado para ser legível por humanos. Ele suporta comentários, strings multilinhas, âncoras e aliases — nenhum dos quais existe no JSON. Ao converter YAML para JSON, esses recursos específicos do YAML são resolvidos: âncoras são expandidas inline, comentários são descartados e blocos multilinhas se tornam strings com escape. O resultado é um JSON válido que qualquer analisador JSON consegue ler.

A especificação YAML 1.2 define explicitamente o JSON como um subconjunto do YAML, o que significa que todo documento JSON válido também é YAML válido. O inverso não é verdadeiro. Documentos YAML que usam comentários, âncoras ou chaves complexas não têm equivalente direto em JSON e precisam ser simplificados durante a conversão. Esta ferramenta realiza essa conversão automaticamente, produzindo JSON limpo e bem formatado a partir de qualquer entrada YAML válida.

YAML 1.2 Specification — yaml.org →

Por que Usar um Conversor Online de YAML para JSON?

Converter YAML para JSON manualmente é propenso a erros, especialmente com estruturas profundamente aninhadas ou valores multilinhas. Um conversor no navegador fornece o resultado instantaneamente e detecta erros de sintaxe YAML antes que cheguem à sua aplicação.

Casos de Uso: YAML para JSON

Referência de Mapeamento de Tipos YAML para JSON

Cada tipo de dado YAML é mapeado para um tipo JSON específico durante a conversão. A tabela abaixo mostra cada construção YAML ao lado da sua saída JSON correspondente. Entender esses mapeamentos ajuda a prever como seus dados YAML ficarão após a conversão e a evitar surpresas com tipos como booleanos ou valores nulos.

Sintaxe YAML vs JSON

YAML e JSON representam o mesmo modelo de dados, mas com regras de sintaxe diferentes. As diferenças abaixo explicam por que alguns recursos do YAML — como comentários e âncoras — não têm equivalente em JSON.

Exemplos de Código

Abaixo estão exemplos funcionais para converter YAML para JSON de forma programática. Cada exemplo analisa uma string YAML e produz JSON formatado.

import { load } from 'js-yaml'

const yamlStr = `
server:
  host: localhost
  port: 8080
  ssl: true
`

const json = JSON.stringify(load(yamlStr), null, 2)
console.log(json)
// → {
// →   "server": {
// →     "host": "localhost",
// →     "port": 8080,
// →     "ssl": true
// →   }
// → }

import yaml, json

yaml_str = """
database:
  host: db.example.com
  port: 5432
  credentials:
    user: admin
    password: s3cret
"""

data = yaml.safe_load(yaml_str)
print(json.dumps(data, indent=2))
# → {
# →   "database": {
# →     "host": "db.example.com",
# →     "port": 5432,
# →     "credentials": {
# →       "user": "admin",
# →       "password": "s3cret"
# →     }
# →   }
# → }

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"gopkg.in/yaml.v3"
)

func main() {
	yamlData := []byte(`
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
`)

	var obj map[string]interface{}
	if err := yaml.Unmarshal(yamlData, &obj); err != nil {
		log.Fatal(err)
	}
	jsonBytes, _ := json.MarshalIndent(obj, "", "  ")
	fmt.Println(string(jsonBytes))
	// → { "services": { "web": { "image": "nginx:latest", "ports": ["80:80"] } } }
}

# Convert a YAML file to JSON with yq
yq -o=json config.yaml > config.json

# Pipe YAML into yq for one-off conversion
echo "name: demo" | yq -o=json
# → { "name": "demo" }

# Python one-liner (no extra install on most systems)
python3 -c "import yaml, json, sys; print(json.dumps(yaml.safe_load(sys.stdin), indent=2))" < config.yaml

Perguntas Frequentes