Utilidades

YAML y JSON

Convertir entre YAML y JSON en ambos sentidos.

Qué hace. Esta herramienta convierte YAML a JSON y a la inversa. YAML usa la sangría para marcar la estructura, y ahí es exactamente donde se rompe: una tabulación en lugar de espacios deja el archivo inválido.

Funciona en tu navegadorNo se sube nadaSin registroFunciona sin conexión

Cómo usar YAML y JSON

Pega YAML o JSON; el formato se reconoce.
Consulta el resultado o el error con su número de línea.
Copia la salida.

Sangrar con espacios, nunca con tabulaciones

La regla más importante de YAML y el error más habitual.

YAML no admite tabulaciones para la sangría. Solo espacios. Un editor que inserta tabulaciones en silencio produce un archivo que parece correcto y no funciona.

El mensaje de error además suele despistar: señala una línea más abajo, donde la estructura acaba fallando de verdad.

Activa en tu editor la conversión de tabulaciones a espacios, y haz visibles los espacios en blanco si trabajas a menudo con YAML.

Dos espacios por nivel es la convención habitual. Más importante que el número es ser coherente dentro de un mismo archivo.

Valores que no querías

YAML adivina el tipo de un valor, y eso se vuelve en tu contra en algunos sitios.

Los valores «yes», «no», «on» y «off» se leen como booleanos en versiones antiguas de YAML. Un código de país «NO» para Noruega se convierte entonces en el valor falso. Entrecomilla esos valores.

Los números con ceros a la izquierda pueden interpretarse como octales. Un número de versión o un código postal debe ir entrecomillado.

Una hora como 12:30 puede entenderse como algo distinto de texto. También ahí, comillas.

Regla práctica: todo lo que sea un identificador en lugar de un valor calculable va entre comillas.

Qué formato para qué

YAML resulta más agradable de escribir y leer a mano: menos puntuación, admite comentarios y texto multilínea sin escapes.

JSON es más estricto y por eso más fiable para intercambiar entre sistemas. Sin comentarios, sin dependencia de la sangría, con menos formas de interpretar mal algo.

En la práctica: configuración que editan personas en YAML, datos que van entre sistemas en JSON.

Algo que recordar al convertir: los comentarios de YAML se pierden al pasar a JSON, que no los tiene. Eso no se recupera.

Todo ocurre en esta página.

Preguntas frecuentes

¿Por qué mi YAML es inválido?

Casi siempre una tabulación en lugar de espacios. YAML no las admite para la sangría.

¿Por qué NO se convierte en falso?

YAML antiguo lee yes, no, on y off como booleanos. Entrecomíllalos.

¿Cuántos espacios por nivel?

Dos es la convención. La coherencia importa más que el número.

¿Se conservan mis comentarios?

No al pasar a JSON, que no los tiene.

¿Qué formato elijo?

YAML para configuración humana, JSON para intercambio entre sistemas.

¿Se transmite mi archivo?

No.