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 vs. YAML: Eligiendo el formato adecuado y cómo convertir

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 / off pueden leerse como booleanos si no van entre comillas (el llamado “problema de Noruega”, en el que el código de país NO pasa a false). Cuando quieras una cadena, hazlo explícito, como en "no".
  • Ceros a la izquierda y números de versión: 08 puede tratarse como octal y provocar un error, y 1.20 puede redondearse al número 1.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 #text y los elementos repetidos a matrices. Los errores de sintaxis incluyen línea y columna.

Pruébalo en la herramienta

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.