Cómo convertir YAML a JSON (y JSON a YAML) sin errores

YAML y JSON son dos formas de escribir los mismos datos. JSON manda en las APIs y en el código; YAML manda en la configuración (Docker Compose, Kubernetes, GitHub Actions, Ansible). Tarde o temprano necesitas pasar de uno a otro —y ahí es donde aparecen los errores de indentación y comillas que hacen perder la tarde.

Esta guía explica cómo convertir entre YAML y JSON en el navegador, los fallos más comunes y cómo evitarlos, y cuándo conviene cada formato.

YAML y JSON: los mismos datos, distinta forma

Ambos representan estructuras de datos: objetos (pares clave-valor), listas y valores simples (texto, números, booleanos). La diferencia es de estilo:

• JSON usa llaves, corchetes y comillas. Es estricto y compacto, ideal para que lo lean máquinas y para viajar por la red.
• YAML usa indentación y guiones en vez de llaves. Es más cómodo para que lo lean y editen personas, por eso domina en los archivos de configuración.

Como describen lo mismo, la conversión es directa: un objeto YAML se vuelve un objeto JSON y viceversa, sin perder información.

Cómo convertir YAML a JSON en el navegador, paso a paso

1. Abre el conversor JSON ⇄ YAML. Se ejecuta entero en tu navegador; tu configuración no se sube a ningún servidor.
2. Pega tu YAML en el cuadro de entrada.
3. Elige la dirección YAML → JSON.
4. Copia el JSON resultante. Si quieres dejarlo bien formateado o validarlo, pásalo por el formateador de JSON.

Para el sentido contrario (JSON → YAML), pega el JSON y cambia la dirección. Es el mismo flujo.

Errores comunes al convertir (y cómo evitarlos)

Casi todos los fallos vienen del lado de YAML, porque es sensible a detalles invisibles:

• Tabulaciones en la indentación: YAML no admite tabuladores para indentar, solo espacios. Un tab escondido es la causa número uno de «mi YAML no convierte». Configura tu editor para insertar espacios.
• Indentación inconsistente: todos los elementos de un mismo nivel deben alinearse con el mismo número de espacios. Dos aquí y cuatro allá rompe la estructura.
• Dos puntos dentro de un valor: una cadena como hora: 12:30 confunde al analizador. Enciérrala entre comillas: hora: "12:30".
• Valores que parecen otra cosa: no, yes, on, off se interpretan como booleanos; un código postal o un número con ceros a la izquierda puede perder los ceros. Si quieres que sea texto, ponlo entre comillas.
• JSON con una coma de más: en el otro sentido, una coma final tras el último elemento ([1, 2, 3,]) es válida en algún dialecto pero no en JSON estándar y hará fallar la conversión.

Una buena herramienta te dice dónde está el error en vez de fallar en silencio, para que lo corrijas sin adivinar.

¿Cuándo usar YAML y cuándo JSON?

• Usa JSON para respuestas de API, para intercambiar datos entre programas y cuando la compacidad importe.
• Usa YAML para configuración que editan personas: pipelines de CI, manifiestos, ajustes de una aplicación. Admite comentarios (JSON no), lo que ayuda a documentar.

Convertir entre ambos te deja trabajar en el formato cómodo y entregar en el que el sistema espera.

Privacidad: tu configuración no se sube

Los archivos de configuración suelen contener nombres de servidores, rutas internas y, a veces, secretos. Convertirlos en una web que los sube a un servidor es un riesgo innecesario. Al convertir en el navegador, tus datos no salen de tu equipo: es más rápido y no hay copia en manos de nadie.