JSON a YAML en Python

Código Python para copiar y pegar en ambos sentidos, más las opciones que mantienen la salida correcta.

Opciones de salida

JSONentrada

Vacío

YAMLsalida

La salida YAML aparece aquí

Se ejecuta íntegramente en tu navegador: no se sube nada. Se aplican límites de uso razonable (5 MB por entrada, conversiones con límite de frecuencia) para evitar el spam y los bots.

Cargar desde URL

Tu navegador obtiene el archivo directamente, por lo que el servidor debe permitir solicitudes de origen cruzado.

Atajos de teclado

Ctrl / ⌘ + Enter Convertir ahora
Ctrl / ⌘ + S Descargar la salida
Alt + Shift + C Copiar la salida
Alt + Shift + F Reparar y formatear el JSON de entrada
Alt + Shift + S Invertir la dirección
Alt + Shift + T Alternar entre las vistas de código, árbol y mapa
Ctrl / ⌘ + Z Deshacer, incluidos Formatear, Reparar y Borrar
Esc Salir de pantalla completa
Tamaño del texto del editor

JSON a YAML y vuelta con PyYAML

PyYAML junto con el módulo estándar json cubre ambos sentidos. Estas opciones dan la salida más limpia.

json_to_yaml.py
import json
import yaml  # pip install pyyaml

with open("data.json", encoding="utf-8") as f:
    data = json.load(f)

with open("data.yaml", "w", encoding="utf-8") as f:
    yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True)
yaml_to_json.py
import json
import yaml  # pip install pyyaml

with open("data.yaml", encoding="utf-8") as f:
    data = yaml.safe_load(f)

with open("data.json", "w", encoding="utf-8") as f:
    # default=str turns dates and datetimes into strings
    json.dump(data, f, indent=2, ensure_ascii=False, default=str)

YAML multidocumento y YAML 1.2

Lee todos los documentos de un archivo al estilo Kubernetes con safe_load_all, o usa ruamel.yaml para las reglas de YAML 1.2 y una sangría precisa.

all_documents.py
import json
import yaml

with open("manifests.yaml", encoding="utf-8") as f:
    docs = list(yaml.safe_load_all(f))  # one item per --- document

print(json.dumps(docs, indent=2, default=str))
ruamel_dump.py
import json
import sys
from ruamel.yaml import YAML  # pip install ruamel.yaml

yaml = YAML()                 # round-trip mode, YAML 1.2
yaml.indent(mapping=2, sequence=4, offset=2)

with open("data.json", encoding="utf-8") as f:
    yaml.dump(json.load(f), sys.stdout)

Comandos de Python de una línea

Prácticos en scripts de shell y en la CI, siempre que PyYAML esté instalado.

bash
# JSON to YAML
python3 -c 'import sys, json, yaml; yaml.safe_dump(json.load(sys.stdin), sys.stdout, sort_keys=False, allow_unicode=True)' < data.json > data.yaml

# YAML to JSON
python3 -c 'import sys, json, yaml; json.dump(yaml.safe_load(sys.stdin), sys.stdout, indent=2, default=str)' < data.yaml > data.json

Problemas comunes y soluciones

Las sorpresas más frecuentes al convertir con PyYAML. Elige una para verla antes y después de la corrección.

SíntomaCausaSolución
Las claves salen ordenadas safe_dump ordena las claves por defecto. Pasa sort_keys=False.
é se convierte en "\xE9" Los caracteres no ASCII se escapan por defecto. Pasa allow_unicode=True.
yes / no / on / off PyYAML sigue YAML 1.1, así que un no sin comillas se carga como False. Entrecomíllalos en el YAML o usa ruamel.yaml (YAML 1.2).
TypeError: datetime is not JSON serializable safe_load convierte 2026-10-01 en un objeto date. Pasa default=str a json.dump.
load() sin Loader PyYAML 6 exige un Loader para yaml.load. Usa yaml.safe_load, que nunca ejecuta código del archivo.
Solo el primer documento safe_load lee un único documento. Usa safe_load_all para archivos separados por ---.

Más herramientas

Conversores, validadores y guías paso a paso para cada lugar donde se encuentran JSON y YAML.

Preguntas frecuentes

¿Cómo convierto JSON a YAML en Python?

Carga el JSON con json.load y escríbelo con yaml.safe_dump de PyYAML: yaml.safe_dump(data, f, sort_keys=False, allow_unicode=True). Las dos opciones mantienen el orden de tus claves y los caracteres no ASCII tal cual.

¿Cómo convierto YAML a JSON en Python?

Lee el archivo con yaml.safe_load y escríbelo con json.dump(data, f, indent=2, default=str). Usa yaml.safe_load_all cuando el archivo contenga varios documentos separados por ---.

¿Debo usar PyYAML o ruamel.yaml?

PyYAML es la opción más común y basta para conversiones puntuales. ruamel.yaml implementa YAML 1.2, conserva los comentarios y el orden de las claves al editar YAML existente y ofrece un control más fino de la sangría.

¿Por qué usar safe_load en lugar de load?

yaml.load con el loader completo puede construir objetos de Python arbitrarios a partir de etiquetas del archivo, lo que no es seguro con entradas no confiables. safe_load solo construye tipos simples: dicts, listas, cadenas, números, booleanos, None y fechas.

¿Puedo convertir sin instalar nada?

Sí. El conversor de la parte superior de esta página se ejecuta en tu navegador y no necesita Python, paquetes ni subir archivos. Pega JSON o YAML y copia el resultado.