JSON a YAML en Python
Código Python para copiar y pegar en ambos sentidos, más las opciones que mantienen la salida correcta.
JSONentrada
YAMLsalida
Cada línea de la salida, con el formato predeterminado, junto a la ruta del valor que contiene. Haz clic en una fila para copiar la ruta.
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.
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.
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) 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.
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)) 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.
# 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íntoma | Causa | Solució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.
Conversores
Formatear y validar
Convertir por caso de uso
- Kubernetes Convierte la salida JSON de kubectl y los objetos de la API en manifiestos limpios, listos para aplicar.
- Docker Compose Crea compose.yaml a partir de JSON, con puertos, entorno y volúmenes.
- GitHub Actions Escribe archivos de flujo de trabajo desde JSON sin la trampa de on: / true.
- OpenAPI / Swagger Convierte especificaciones OpenAPI 3 y Swagger 2.0 entre JSON y YAML.
- CloudFormation Convierte plantillas de AWS CloudFormation de JSON a YAML, funciones intrínsecas incluidas.
Guías de código y línea de comandos
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.