¿Qué hace un conversor de JSON a YAML?
Un conversor de JSON a YAML reescribe datos JSON en YAML («YAML Ain’t Markup Language»), un formato pensado para personas que usa la sangría en lugar de llaves y comillas. Ambos formatos representan las mismas estructuras: objetos (mapas), arrays (listas), cadenas, números, booleanos y null. El YAML es mucho más fácil de leer y editar a mano, y por eso domina en los archivos de configuración de Kubernetes, Docker Compose, GitHub Actions, GitLab CI, Ansible, Helm y OpenAPI.
Esta herramienta convierte en ambos sentidos. Pega JSON para obtener YAML limpio o cambia a YAML → JSON para convertir un archivo de configuración en JSON para una API o un programa. Las entradas no válidas se indican con la línea y la columna del problema.
Cómo convertir JSON a YAML
- Pega tu JSON o suelta un archivo .json. Para el sentido contrario, pega YAML o suelta un archivo .yaml.
- Elige la dirección: JSON → YAML o YAML → JSON.
- Ajusta el formato: sangría, estilo de comillas, orden de las claves y arrays compactos.
- Copia o descarga el archivo .yaml o .json resultante.
JSON frente a YAML: un ejemplo
JSON:
{"service": {"name": "web", "ports": [80, 443], "env": {"DEBUG": false}}}
YAML:
service:
name: web
ports:
- 80
- 443
env:
DEBUG: false
Funciones
- En ambos sentidosJSON a YAML y YAML a JSON en una sola herramienta.
- YAML conforme a la especificaciónBasado en js-yaml, un analizador y serializador de YAML 1.2 muy extendido.
- Errores clarosLos errores de sintaxis indican la línea y la columna exactas.
- Control del formatoSangría, comillas, orden de claves y arrays en estilo flow.
- Análisis seguroEl YAML se carga con el esquema seguro: no es posible ejecutar código.
- PrivadoLas configuraciones con secretos se quedan en tu navegador.
JSON o YAML: cuándo usar cada uno
| JSON | YAML | |
|---|---|---|
| Legibilidad | buena | excelente |
| Comentarios | no permitidos | con # |
| Ideal para | API, intercambio de datos | archivos de configuración |
| Sensible a los espacios | no | sí (la sangría importa) |
| Velocidad de análisis | muy rápida | más lenta |
Dónde usarás esta conversión
- Kubernetes: convertir la salida de
kubectl get -o jsonen manifiestos YAML editables. - OpenAPI / Swagger: las especificaciones de API suelen escribirse en YAML y consumirse en JSON, o al revés.
- Pipelines de CI/CD: GitHub Actions, GitLab CI, CircleCI y Azure Pipelines usan YAML.
- Infraestructura como código: playbooks de Ansible, plantillas de CloudFormation y archivos de valores de Helm.
Lo esencial de la sintaxis YAML
- Los mapas se escriben como
clave: valory el anidamiento se marca con la sangría (normalmente dos espacios). - Las listas usan un guion y un espacio (
- elemento) o el estilo flow[a, b, c]. - Las cadenas normalmente no necesitan comillas, salvo si contienen
:o#, empiezan por un carácter especial o podrían confundirse con un número o un booleano (por ejemplo'3.10','yes','on'). - Los comentarios empiezan por
#y llegan hasta el final de la línea. - Las cadenas de varias líneas usan
|para conservar los saltos de línea o>para plegarlos. - Varios documentos en un archivo se separan con
---, como en los manifiestos de Kubernetes con varios recursos.
El «problema de Noruega» y otras trampas del YAML
En los analizadores antiguos de YAML 1.1, valores sin comillas como NO, yes, on y off se leían como booleanos, así que el código de país de Noruega podía convertirse en false sin avisar. Las versiones como 3.10 también pueden acabar como el número 3,1. Al convertir JSON a YAML, esta herramienta pone comillas automáticamente a las cadenas que YAML 1.2 leería como otro tipo, como '3.10', 'true', 'null' o '0123'. Si tu YAML lo va a leer un analizador antiguo de YAML 1.1 (por ejemplo PyYAML o algunos sistemas de CI), elige comillas simples o dobles en «Comillas de las cadenas»: todas las cadenas irán entre comillas, lo que protege también palabras como yes, no, on y off. En YAML → JSON se usa el esquema JSON estricto, así que solo true y false se convierten en booleanos. Para validar y dar formato a JSON, usa el formateador JSON; para XML, JSON a XML.
Preguntas frecuentes
¿El conversor de JSON a YAML es gratis?
Sí, sin límites. Pega JSON o YAML de cualquier tamaño y conviértelo al instante en tu navegador.
¿Puede convertir YAML con varios documentos?
La dirección YAML → JSON lee un único documento. Si el archivo tiene varios separados por ---, pégalos de uno en uno.
¿El YAML mantiene el orden de las claves?
Sí. Las claves aparecen en el mismo orden que en el JSON, salvo que actives «Ordenar claves A–Z».
¿YAML es un superconjunto de JSON?
Sí. YAML 1.2 está diseñado para que un JSON válido sea también YAML válido. Al revés no: funciones de YAML como los comentarios y las anclas no tienen equivalente en JSON.
¿Qué pasa con los comentarios de YAML al convertir a JSON?
JSON no admite comentarios, así que se eliminan. Volver a convertir a YAML no los recupera.
¿Por qué la sangría de YAML debe hacerse con espacios?
La especificación de YAML prohíbe los tabuladores para sangrar. Esta herramienta siempre usa espacios, 2 o 4 por nivel.
¿Se sube mi configuración?
No. La conversión se hace por completo en tu navegador, así que los secretos y credenciales de tus configuraciones siguen siendo privados.