JSON a YAML

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

La conversión de JSON a YAML transforma datos de JavaScript Object Notation a YAML Ain't Markup Language. Ambos formatos representan las mismas estructuras de datos (objetos, arrays, cadenas, números, booleanos, null), pero usan sintaxis diferente. JSON usa llaves, corchetes y comas. YAML usa indentación y saltos de línea, produciendo una salida que se lee más como texto plano. A diferencia de XML, ninguno de los dos requiere un esquema.

YAML fue diseñado como un formato de serialización de datos amigable para humanos. Es el lenguaje de configuración predeterminado para manifiestos de Kubernetes, archivos Docker Compose, playbooks de Ansible, flujos de trabajo de GitHub Actions y muchos sistemas CI/CD. Cuando tus datos de origen están en JSON y el sistema destino espera YAML, necesitas un conversor que preserve cada valor, tipo y nivel de anidamiento exactamente, sin pérdida de datos.

Convertir JSON a YAML en línea es útil cuando recibes respuestas de API o datos exportados en JSON y necesitas pegarlos en un archivo de configuración YAML. La conversión no tiene pérdidas para todos los tipos JSON estándar: cadenas, números, booleanos, null, arrays y objetos se mapean directamente a sus equivalentes YAML. Los valores que contienen dos puntos o caracteres especiales se entrecomillan automáticamente para que la salida sea YAML válido.

¿Por qué convertir JSON a YAML?

YAML es el estándar para archivos de configuración; JSON es lo que devuelven las APIs. Convertir entre ellos te permite usar el formato adecuado para cada tarea sin reescribir los datos a mano.

Casos de uso de JSON a YAML

Comparativa JSON vs YAML

JSON y YAML pueden representar los mismos datos, pero su sintaxis y capacidades difieren de formas que importan en casos de uso concretos.

Trampas de YAML tras la conversión

YAML tiene reglas de análisis que sorprenden a los desarrolladores que vienen de JSON. Estos cuatro problemas causan la mayoría de los bugs al trabajar con la salida convertida.

Ejemplos de código

Convertir JSON a YAML de forma programática requiere una librería de serialización YAML en la mayoría de los lenguajes. La librería estándar gestiona el análisis JSON; la salida YAML necesita un paquete adicional.

import YAML from 'js-yaml'

const json = '{"host":"localhost","port":3000,"debug":true}'
const obj = JSON.parse(json)
const yamlStr = YAML.dump(obj, { indent: 2 })
console.log(yamlStr)
// → host: localhost
// → port: 3000
// → debug: true

import json, yaml

json_str = '{"host": "localhost", "port": 3000, "debug": true}'
data = json.loads(json_str)
yaml_str = yaml.dump(data, default_flow_style=False, sort_keys=False)
print(yaml_str)
# → host: localhost
# → port: 3000
# → debug: true

package main

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

func main() {
    jsonStr := `{"host":"localhost","port":3000,"debug":true}`
    var data map[string]interface{}
    json.Unmarshal([]byte(jsonStr), &data)

    yamlBytes, _ := yaml.Marshal(data)
    fmt.Println(string(yamlBytes))
    // → debug: true
    // → host: localhost
    // → port: 3000
}

# Using yq (https://github.com/mikefarah/yq)
echo '{"host":"localhost","port":3000}' | yq -P
# → host: localhost
# → port: 3000

# Using Python one-liner
echo '{"host":"localhost","port":3000}' | python3 -c "import sys,json,yaml; print(yaml.dump(json.load(sys.stdin), default_flow_style=False))"

Preguntas frecuentes