Herramientas mencionadas en este artículo
Abre la herramienta en el navegador mientras lees y prueba el flujo al instante.
JSON y YAML: Dos formatos de datos clave
En el desarrollo moderno, guardar y transferir datos generalmente implica el uso de JSON o YAML. Cada uno tiene sus propias fortalezas y escenarios ideales.

JSON (JavaScript Object Notation)
- Características: Ligero y rápido de analizar. Afinidad extremadamente alta con JavaScript.
- Usos comunes: API web (REST), comunicación de solicitud/respuesta en el frontend.
- Debilidades: No admite comentarios. Excepcionalmente estricto con las comas finales.
YAML (YAML Ain’t Markup Language)
- Características: Altamente legible para humanos.
- Usos comunes: Archivos de configuración (Docker, Kubernetes, GitHub Actions), canalizaciones de CI/CD.
- Debilidades: Extremadamente estricto con la sangría (espacios en blanco). El análisis es significativamente más complejo en comparación con JSON.
Cuándo es necesario convertir entre ellos
- Edición de archivos de configuración: Es posible que desees tomar una configuración JSON de una API y convertirla a un formato YAML legible para su edición local.
- Inserción de datos: Administras tus configuraciones en YAML para mayor legibilidad, pero necesitas convertirlas a JSON para enviarlas a través de una API.
- Depuración: Convierte rápidamente un fragmento de JSON desordenado de una sola línea a YAML para comprender instantáneamente su estructura.
Ejemplo: revisar la configuración de una API en YAML
Supón que recibes esta configuración JSON de una API.
{
"retries": 3,
"timeoutMs": 30000,
"features": {
"csvExport": true,
"betaDashboard": false
}
}
Convertirla a YAML para revisarla hace más legible la jerarquía.
retries: 3
timeoutMs: 30000
features:
csvExport: true
betaDashboard: false
En esta forma es más fácil confirmar si el tiempo de espera está en milisegundos y dónde se sitúa cada feature flag en la jerarquía.
JSON frente a YAML de un vistazo
| Aspecto | JSON | YAML |
|---|---|---|
| Legibilidad | Más símbolos | Basado en la indentación y fácil de leer |
| Comentarios | No se permiten | Se permiten con # |
| Comas finales | No se permiten (error) | No hacen falta comas |
| Cadenas de varias líneas | Se escapan con \n |
| (conserva los saltos de línea) / > (pliega) |
| Uso principal | API web y transferencia de datos | Archivos de configuración y CI/CD |
| Rigor del análisis | Sintaxis estricta con poca ambigüedad | Depende de la indentación y se rompe con facilidad |
JSON es casi un subconjunto de YAML, y un JSON válido por lo general también se interpreta como YAML válido. Por eso la conversión entre ambos es fluida.
Trampas propias de YAML
YAML es “amable con las personas”, pero es fácil caer en la conversión implícita de tipos. Ten presentes estos puntos al escribir archivos de configuración.
- Cadenas que se convierten en booleanos:
yes/no/on/offpueden leerse como booleanos si no van entre comillas (el llamado “problema de Noruega”, en el que el código de paísNOpasa afalse). Cuando quieras una cadena, hazlo explícito, como en"no". - Ceros a la izquierda y números de versión:
08puede tratarse como octal y provocar un error, y1.20puede redondearse al número1.2. Pon entre comillas versiones y códigos postales, como en"1.20". - No se pueden usar tabuladores para la indentación: YAML solo admite espacios. Un tabulador mezclado provoca un error de análisis.
Si tienes dudas, convierte una vez a JSON. Queda claro si un valor es una cadena o un número, y notarás estas conversiones implícitas.
Conversión perfecta con DevToolKits
Nuestro Convertidor JSON ⇔ YAML permite una conversión bidireccional sin esfuerzo con un solo clic. Pega tu JSON para obtener YAML, o pega tu YAML para obtener JSON; es así de simple.
💡 Nota: Dado que JSON no admite comentarios, la conversión de YAML a JSON hará que se pierdan los comentarios en el código fuente de YAML. Esta herramienta se utiliza mejor para transformaciones de estructuras de datos puras.
Novedades de noviembre de 2026
- TOML ⇄ JSON / YAML: convierte TOML como Cargo.toml o pyproject.toml a JSON o YAML, y JSON o YAML a TOML. TOML no tiene null y exige una tabla en el nivel superior, así que la herramienta indica dónde falla.
- XML ⇄ JSON: los atributos pasan a ser
@nombre, el texto a#texty los elementos repetidos a matrices. Los errores de sintaxis incluyen línea y columna.
Preguntas frecuentes
¿Cuál debo usar, JSON o YAML?
Para la comunicación máquina a máquina (API web), JSON es rápido de analizar y menos ambiguo. Para archivos de configuración editados por humanos (Docker, Kubernetes, CI/CD), YAML permite comentarios y es más legible. Como son interconvertibles, la regla básica es usar cada uno donde corresponda.
Mis comentarios desaparecen al convertir YAML.
JSON no tiene el concepto de comentarios, así que un viaje de ida y vuelta YAML → JSON → YAML los pierde. Para archivos de configuración donde quieras conservar comentarios, vuelve a escribirlos a mano tras la conversión, o usa la conversión solo para estructuras de datos puras.
Obtengo errores de sangría en YAML.
YAML es estricto con la sangría de espacios y no permite tabulaciones. Una jerarquía mal alineada provoca errores de análisis o una estructura no deseada. Convertir a JSON para verificar la estructura y luego volver a YAML facilita detectar la sangría rota.
no o 1.20 cambian a un valor que no quería.
YAML realiza conversión implícita de tipos, así que yes / no / on / off pueden leerse como booleanos y 1.20 como el número 1.2. Pon entre comillas los valores que quieras como cadenas, como en "no" o "1.20". Al convertir a JSON puedes ver como qué tipo se leyó realmente cada valor.
¿Cómo escribo una cadena de varias líneas en YAML?
Usa | (un bloque literal) para conservar los saltos de línea tal cual, o > (un bloque plegado) para plegar una frase larga y tratarla como una sola línea. Al convertir a JSON se obtiene una única cadena con \n, de modo que puedes comprobar que los saltos de línea se conservaron correctamente.
