ConvertBox Logo
ConvertBox

JSON, YAML y XML: diferencias y qué se pierde al convertir

JSON, YAML y XML tienen modelos de datos distintos, así que convertir entre ellos es aplicar reglas de correspondencia y no cambiar de notación. Comentarios, anclas, atributos, la forma de los arrays y los tipos de los valores son lo que más a menudo no sobrevive.

ConvertBoxPublicado

Tres modelos de datos, no tres formas de escribir lo mismo

JSON, YAML y XML suelen presentarse como maneras intercambiables de escribir los mismos datos. No lo son: cada uno tiene su propio modelo de datos, y un conversor tiene que inventar una regla allí donde los modelos no coinciden. JSON tiene exactamente seis clases de valor. YAML 1.2 puede expresar todo lo que expresa JSON, y se diseñó para que un documento JSON sea también YAML válido; además añade comentarios, referencias y varias formas de escribir una cadena. XML es un formato de documentos: un árbol de elementos con nombre que llevan atributos y texto, sin noción propia de número, booleano o array.

JSONYAMLXML
Tipos de valorCadena, número, booleano, null, array, objetoLos tipos de JSON, deducidos de cómo se escribe un valor sin comillasSolo texto; los tipos los pone un esquema o quien lo lee
ComentariosNo hay# hasta el final de la línea<!-- ... -->
AtributosNo hayNo haySí: <user id="7">
Reutilizar un bloqueNo hayAnclas y alias: &base, *baseSolo mediante entidades de la DTD
Texto mezclado con marcadoNoNoSí: <p>Hello <b>world</b></p>
Reglas de sintaxisSolo comillas dobles, sin coma finalLa sangría es la estructura; no se puede sangrar con tabuladoresTodas las etiquetas cerradas y un único elemento raíz

Cuánto exige cada analizador y dónde se esconden los errores

JSON (RFC 8259) es el más estricto de los tres al escribir: las claves y las cadenas necesitan comillas dobles, una coma final es un error y los comentarios no existen. La ventaja es que un documento se analiza o falla de forma visible. Cuando el formateador de JSON del sitio muestra un error en lugar de un resultado, la causa es un defecto real, normalmente una coma final, comillas simples, un comentario o un valor como NaN pegado desde la consola de JavaScript.

XML es igual de inflexible con la buena formación: todas las etiquetas cerradas, los valores de atributo entre comillas y exactamente un elemento raíz. Además, un lenguaje de esquemas como XSD puede comprobar que los elementos correctos aparecen en el orden correcto y con los tipos correctos, algo que ni JSON ni YAML traen incorporado. YAML es el caso contrario. Es fácil de escribir, pero la estructura sale de la sangría, de modo que una línea sangrada dos espacios de más sigue siendo YAML válido con otro significado, y nada te avisa. Convertir un archivo YAML a JSON es una forma práctica de ver qué entendió realmente el analizador, porque las llaves y los corchetes hacen explícito el anidamiento.

Dónde es habitual cada formato

  • JSON para el intercambio entre programas: API web, almacenamiento del navegador, registros de log, manifiestos de paquetes. Todos los lenguajes habituales lo analizan de forma nativa y su conjunto de tipos coincide con el que usan los programas.
  • YAML para archivos que las personas editan a mano: manifiestos de Kubernetes, archivos de Docker Compose, definiciones de pipelines de CI, playbooks de Ansible. Los comentarios y las anclas mantienen legible una configuración larga.
  • XML para documentos e intercambios regidos por un esquema: servicios SOAP, fuentes RSS y Atom, SVG, las partes internas de los archivos .docx y .xlsx. Úsalo cuando se mezclan texto y marcado o cuando el destinatario valida contra un XSD.
  • Una regla práctica: si lo escribe un programa y lo lee un programa, JSON; si lo mantiene una persona, YAML; si una norma o la otra parte dictan los nombres de los elementos, XML.

La conversión de tipos de YAML y el problema de Noruega

YAML decide el tipo de un valor sin comillas por cómo está escrito, y las reglas cambiaron entre versiones. YAML 1.1 trata yes, no, on, off y sus variantes en mayúsculas como booleanos, así que una lista de códigos de país que contenga NO, de Noruega, vuelve con un false dentro. YAML 1.2 conservó solo true y false, pero analizadores muy usados, PyYAML entre ellos, siguen las reglas de 1.1. Por eso un mismo archivo puede significar cosas distintas para dos herramientas.

La defensa es la misma en todas partes: pon entre comillas cualquier cadena que pueda leerse como otro tipo. El conversor de JSON a YAML del sitio lo hace al escribir: pone comillas simples a cadenas como '012', 'true' y '2024-01-01', y también a las palabras yes, no, on y off de YAML 1.1, de modo que el resultado sobrevive a los analizadores antiguos.

YAML sin comillasAnalizador YAML 1.1 (como PyYAML)YAML a JSON de ConvertBox (js-yaml, reglas de YAML 1.2)
country: NOfalse"NO"
enabled: yestrue"yes"
zip: 01210 (leído como octal)12
version: 1.201.21.2
released: 2024-01-01Un valor de fecha"2024-01-01T00:00:00.000Z"

JSON y YAML: qué se cae en un viaje de ida y vuelta

De JSON a YAML no se pierden datos, porque todo valor JSON tiene una forma en YAML. Lo que puede cambiar es accesorio: los conversores del sitio leen primero la entrada con el analizador de JSON del navegador, así que 1.0 se escribe como 1, los enteros por encima de 2^53 (9007199254740991) pierden sus últimas cifras, las claves duplicadas se reducen a la última y las claves que parecen enteros pasan al principio de su objeto.

De YAML a JSON es donde desaparece información. Los comentarios se eliminan. Un ancla (&base) y sus alias (*base) se expanden en copias completas, y las claves de fusión (<<: *base) se sustituyen por el resultado fusionado, de modo que el JSON es correcto pero ya no consta que cinco servicios compartían un mismo bloque. Los escalares de bloque pasan a ser cadenas normales, las claves que no son cadenas se convierten en cadenas, y .inf y .nan se convierten en null porque JSON no tiene esos números. Además, la herramienta de YAML a JSON rechaza un flujo de varios documentos separados por --- y las etiquetas propias de una aplicación, como !Ref de CloudFormation, así que convierte los documentos de uno en uno. Trata el archivo YAML como la fuente original: al convertir a JSON y volver obtienes datos equivalentes, nunca el archivo de partida.

JSON y XML: atributos, elementos repetidos y tipos

XML no tiene arrays y JSON no tiene atributos, así que cada conversor adopta una convención, y las convenciones difieren entre herramientas. La tabla recoge las que usan los dos conversores del sitio.

En el sentido de JSON a XML, la herramienta envuelve todo en un elemento llamado root, nunca genera atributos y sustituye por guiones bajos los caracteres que no son válidos en un nombre de elemento: una clave como first name pasa a ser first_name, y en una clave como año la ñ se convierte en un guion bajo. Para un formato con nombres de elemento, espacios de nombres o atributos fijos, como SOAP o RSS, hay que retocar el resultado a mano o usar una biblioteca que acepte una correspondencia explícita.

EntradaSalidaQué vigilar
JSON "tag": ["a", "b"]<tag>a</tag> <tag>b</tag>Un array se convierte en elementos repetidos sin envoltorio
XML <tag>a</tag> una sola vez"tag": "a"Un elemento da una cadena; dos dan un array
JSON "age": 30, "ok": true<age>30</age> <ok>true</ok>Al volver a JSON, ambos son cadenas: "30" y "true"
JSON "items": []NadaUn array vacío no deja rastro
XML <user id="7">Ann</user>"user": {"@attributes": {"id": "7"}, "#text": "Ann"}Los atributos se guardan bajo una clave reservada
XML <p>Hello <b>big</b> world</p>"p": {"b": "big"}El texto situado entre elementos hijos se descarta

Comprobaciones que conviene hacer antes de convertir un archivo real

  • Pon entre comillas las cadenas de YAML que parezcan números, booleanos o fechas: números de versión, códigos postales, códigos de país, horas.
  • Transporta como cadenas los identificadores de más de 15 cifras; las herramientas basadas en JavaScript redondean los enteros superiores a 2^53.
  • Después de pasar de XML a JSON, escribe código que acepte tanto un valor único como un array en cualquier elemento que pueda repetirse.
  • Si una firma o una suma de comprobación cubre los bytes exactos, verifícala antes de formatear o convertir, porque cualquier nueva serialización cambia los bytes.

Herramientas mencionadas en esta guía

Guías relacionadas

Todas las guías