YAML a JSON

¿Qué es la conversión de YAML a JSON?

La conversión de YAML a JSON transforma datos escritos en YAML (YAML Ain't Markup Language) a JSON (JavaScript Object Notation). Ambos formatos representan datos estructurados como pares clave-valor, secuencias y objetos anidados, pero difieren en la sintaxis. YAML usa indentación y puntuación mínima, mientras que JSON usa llaves, corchetes y comillas obligatorias. Convertir entre ambos es una tarea habitual cuando se trasladan datos de configuración entre sistemas que esperan formatos distintos.

YAML fue diseñado para ser legible por humanos. Admite comentarios, cadenas multilínea, anclas y alias, ninguno de los cuales existe en JSON. Al convertir YAML a JSON, estas características propias de YAML se resuelven: las anclas se expanden en línea, los comentarios se descartan y los bloques multilínea se convierten en cadenas escapadas. El resultado es JSON válido que cualquier analizador JSON puede leer.

La especificación YAML 1.2 define explícitamente JSON como un subconjunto de YAML, lo que significa que todo documento JSON válido también es YAML válido. Lo contrario no es cierto. Los documentos YAML que usan comentarios, anclas o claves complejas no tienen un equivalente JSON directo y deben simplificarse durante la conversión. Esta herramienta gestiona esa conversión de forma automática, produciendo JSON limpio y bien formateado a partir de cualquier entrada YAML válida.

YAML 1.2 Specification — yaml.org →

¿Por qué usar un convertidor de YAML a JSON online?

Convertir YAML a JSON a mano es propenso a errores, especialmente con estructuras muy anidadas o valores multilínea. Un convertidor en el navegador te da el resultado al instante y detecta errores de sintaxis YAML antes de que lleguen a tu aplicación.

Casos de uso de YAML a JSON

Referencia de mapeo de tipos YAML a JSON

Cada tipo de dato YAML se mapea a un tipo JSON específico durante la conversión. La tabla siguiente muestra cada construcción YAML junto con su salida JSON. Entender estos mapeos te ayuda a predecir cómo quedarán tus datos YAML tras la conversión y a evitar sorpresas con tipos como booleanos o valores null.

Sintaxis YAML vs JSON

YAML y JSON representan el mismo modelo de datos pero con reglas de sintaxis distintas. Las diferencias a continuación explican por qué algunas características de YAML — como los comentarios y las anclas — no tienen equivalente en JSON.

Ejemplos de código

A continuación se muestran ejemplos funcionales para convertir YAML a JSON de forma programática. Cada ejemplo analiza una cadena YAML y produce JSON formateado.

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

Preguntas frecuentes