IA en tu dispositivo: profesional y privado.

Documentos

Cómo convertir JSON a YAML y YAML a JSON (sin estropear tus valores)

Convierte JSON a YAML o YAML a JSON para Kubernetes, Docker Compose y CI. Conoce el problema de Noruega, las trampas de tabuladores y sangría, y qué se pierde.

Actualizado el 7 de noviembre de 202610 min de lectura

Para convertir JSON a YAML, pega el JSON en el convertidor de JSON a YAML, elige el analizador para el que es tu YAML y pulsa Convertir a YAML. Para hacerlo al revés, pega el YAML en el convertidor de YAML a JSON. Ambos tardan segundos. Lo que merece la pena leer es qué puede salir mal: YAML adivina el tipo de las palabras sin comillas, así que un código de país como no puede convertirse en false, un permiso de archivo puede convertirse en otro número y una fecha puede dejar de ser texto. Esta guía cubre las dos direcciones, esas trampas y lo que se pierde por el camino.

Dos direcciones, dos herramientas

JSON y YAML describen los mismos tipos de datos: objetos, listas, texto, números, verdadero o falso, y null. JSON es estricto y ruidoso, con llaves, corchetes y comillas por todas partes. YAML elimina casi todo eso y usa la sangría en su lugar, por eso se prefiere para los archivos que se editan a mano. Cada dirección tiene su propia herramienta, con sus propios límites.

TienesQuieresHerramientaLímite gratuito
JSON, una respuesta de API o una exportaciónYAMLJSON a YAMLUn archivo de hasta 10 MB
Una configuración o un manifiesto YAMLJSONYAML a JSONUn archivo de hasta 25 MB
JSON que no se puede analizarJSON corregidoValidador de JSONConsulta la página de la herramienta
JSON desordenado en una sola líneaJSON legibleFormateador de JSONConsulta la página de la herramienta

Los límites difieren porque el trabajo difiere. Convertir JSON a YAML implica mantener todo el documento como objetos vivos mientras se escribe el YAML, y por eso esa herramienta se detiene en 10 MB. Leer YAML recorre el texto, así que tiene margen hasta 25 MB.

Convertir JSON a YAML, paso a paso

1

Añade tu JSON

Abre el convertidor de JSON a YAML. Pega el JSON en el editor y pulsa Usar este JSON, o suelta un archivo .json, .ndjson o .jsonl en la página.

2

Elige el Analizador de destino

El valor por defecto es Portable, que entrecomilla todo valor que un lector YAML antiguo o con soporte de fechas interpretaría como otro tipo. YAML 1.2 entrecomilla solo lo que necesita un analizador moderno. Entrecomillar todo pone comillas a cada cadena cuando no sabes qué leerá el archivo.

3

Ajusta el diseño

Elige una Sangría de 1 a 8 espacios (2 es el valor por defecto), un Estilo de null entre null, ~ o vacío, y si el archivo empieza con ---.

4

Convierte y mira la insignia

Pulsa Convertir a YAML. Con Verificar el resultado activado, el YAML se vuelve a leer con un analizador independiente y se compara con tu JSON. La insignia dice Verificado, o nombra la primera ruta en la que un valor volvió distinto.

5

Descarga o copia

Usa Descargar YAML o Copiar. La vista previa muestra las primeras líneas en los archivos grandes, pero la descarga es el resultado completo.

Convertir YAML a JSON

Pega YAML en el convertidor de YAML a JSON o suelta un archivo .yaml o .yml. Los botones de ejemplo de Kubernetes, Docker Compose y GitHub Actions cargan un archivo típico para que veas primero el resultado. Todos los ajustes de salida son gratuitos:

  • Sangría: 2 espacios, 4 espacios, Tabulaciones o Minificado (una línea, sin espacios en blanco).
  • Documentos: Automático (un documento se convierte en objeto, varios en un array), Siempre array, Solo el primero o Archivos separados, un .json por documento.
  • Ordenar claves: pone las claves de cada objeto en un orden estable para que dos conversiones se comparen limpiamente.
  • Claves duplicadas: Rechazar, que indica la línea, o Conservar la última.
  • NaN e Infinity: Escribir null, Como texto o Detener. JSON no tiene valor para .nan ni .inf.
  • Marcas de tiempo: Tal cual, o ISO 8601.

Los anclajes y alias se expanden allí donde se usan, y las claves de combinación como <<: *common se resuelven; las claves escritas directamente en un mapa prevalecen sobre las combinadas. Las etiquetas como !Ref se reducen al valor que llevan debajo, y los nombres de las etiquetas se enumeran bajo el resultado.

Elige el analizador, convierte y obtén un resultado verificado. Gratis: un archivo de hasta 10 MB, con todos los ajustes que afectan a la corrección incluidos. Pro: hasta 50 archivos en un ZIP, más estilos de salida. Todo se ejecuta en tu dispositivo, no en nuestros servidores.

Convertir JSON a YAML

El problema de Noruega y otros cambios de tipo silenciosos

En YAML 1.1, la versión que aún usan PyYAML, Ansible y Psych de Ruby, las palabras sueltas yes, no, on, off, y y n son booleanos. Una lista de códigos de país que incluya NO (Noruega) vuelve por tanto con false en su lugar. Nada avisa de un error; los datos simplemente son incorrectos. YAML 1.2 eliminó esa regla, así que unos analizadores leen el mismo archivo de forma distinta a otros. Ese desacuerdo es la razón de ser del ajuste Analizador de destino.

Valor en tu JSONQué puede hacer con él un lector YAML antiguoDestino Portable
"no", "yes", "on", "off"Booleanos, así que "no" pasa a ser falseEntrecomillado
"0755"Un número octal, 493Entrecomillado
"1:30"Un número en base 60, 90Entrecomillado
"2024-01-01"Un objeto de fecha, no textoEntrecomillado
"true", "null", "12"Un booleano, null o un número, en cualquier versión de YAMLEntrecomillado (en todos los modos)
"hello"TextoSin comillas

Portable entrecomilla exactamente los valores de esa tabla y deja en paz las palabras normales, de modo que el archivo sigue siendo legible. El modo YAML 1.2 entrecomilla menos y solo es correcto si lo que lee el archivo es un analizador 1.2 sin tratamiento de fechas; aun así, la herramienta cuenta cuántos valores cambiaría un lector antiguo y te lo indica. Las claves se entrecomillan con las mismas reglas, porque una clave n o yes sin comillas se convierte en booleana en un lector 1.1. En el sentido contrario, YAML a JSON sigue las reglas de YAML 1.2: yes, no, on y off siguen siendo cadenas, y una marca de tiempo como 2001-12-14 sigue siendo el texto que escribiste, salvo que elijas ISO 8601.

Sangría, tabuladores y valores vacíos

La estructura de YAML es la sangría. Dos espacios más significan un hijo; la misma sangría significa un hermano. Una sola línea con un espacio de más cambia la forma de los datos o detiene el análisis. Los tabuladores son el fallo clásico: YAML los prohíbe para la sangría, y un archivo que parece alineado en un editor con tabulaciones puede negarse a cargar. El convertidor de YAML a JSON indica la línea y la columna del fallo, con unas líneas de tu propio texto y un signo de intercalación debajo. Sustituye el tabulador por espacios y vuelve a convertir.

JSON a YAML no tiene ese riesgo, porque la herramienta escribe la sangría por ti. Los contenedores vacíos se escriben como {} y [] en lugar de dejarse en blanco, porque un valor en blanco se lee de vuelta como null. El texto con saltos de línea se convierte en un bloque | legible, de modo que un script o un certificado conserva sus líneas. Si un bloque no puede representar el texto con exactitud, por ejemplo cuando la primera línea está en blanco o con sangría, o contiene un retorno de carro, el texto se entrecomilla. Los cambios silenciosos son peores que un resultado feo.

Qué se pierde al pasar a JSON: comentarios y nodos compartidos

JSON no tiene comentarios. Al convertir YAML a JSON se descartan todos los comentarios con #, y con ellos la documentación que llevaban. Conserva el YAML como fuente de verdad y trata el JSON como un resultado de compilación. Al pasar de JSON a YAML ganas la posibilidad de escribir comentarios, pero empiezas sin ninguno, así que añádelos después de convertir.

Los alias también se aplanan. Dos lugares que se referían a un mismo anclaje se convierten en dos copias idénticas en el JSON, porque JSON no puede expresar que eran el mismo nodo. Al volver a convertir obtienes un YAML más largo que el original. Un alias circular, en el que un anclaje se refiere a sí mismo, es YAML legal pero imposible en JSON, y el convertidor lo notifica con la ruta en lugar de fallar en silencio.

Usos típicos: Kubernetes, Docker Compose y archivos de CI

  • Kubernetes: un manifiesto separado por --- son varios documentos. Usa Automático o Siempre array para obtenerlos como JSON para una herramienta que lo espera, o Archivos separados para un .json cada uno. Al ir a YAML, ajusta el diseño y mira la insignia, porque una etiqueta de versión como "1.20" debe seguir siendo texto.
  • Docker Compose: un servicio definido con <<: *common sale con las claves compartidas ya combinadas. Las asignaciones de puertos como "22:22" son la trampa de la versión 1.1 en la práctica, porque un 22:22 sin comillas puede leerse como un número en base 60. Portable las entrecomilla.
  • Archivos de CI como los flujos de GitHub Actions: la clave on sigue siendo la cadena "on", no true. Es la lectura correcta para un analizador 1.2. Para comparar dos archivos de flujo, conviértelos con Ordenar claves activado; cambia el orden, no el significado.
  • Cargas de API: convierte una respuesta JSON en una configuración YAML de partida, o un archivo de ajustes YAML en el cuerpo para un servicio que no lee YAML.

Para ver en qué se diferencian dos configuraciones, convierte ambas, ordena las claves y compara el JSON; así los cambios de orden y de comentarios dejan de aparecer como diferencias. Para ordenar antes el JSON, consulta cómo dar formato a JSON en línea, y para fuentes XML, convertir XML a JSON.

Cuando la conversión falla

Si el JSON no se puede analizar, el convertidor muestra la línea y la columna, un signo bajo el carácter exacto y lo que se esperaba allí. Las causas habituales son una coma final, comillas simples en lugar de dobles, un comentario o una clave sin comillas. El Validador de JSON enumera los fallos de una sola pasada, y el Formateador de JSON hace más fácil ver la estructura. Corrige la sintaxis y vuelve a convertir.

  • Archivo demasiado grande: los límites gratuitos son 10 MB para JSON a YAML y 25 MB para YAML a JSON. Divide el archivo o usa Pro.
  • Varios archivos a la vez: Gratis convierte uno cada vez. Pro pone en cola hasta 50 y los descarga en un único ZIP; YAML a JSON también puede reunir todos los documentos de todos los archivos en un solo array.
  • Claves duplicadas en YAML: por defecto se rechaza y se nombra la segunda clave. JSON no puede contener ambas, así que elige Conservar la última solo cuando sepas qué valor quieres.
  • Un valor distinto tras convertir: el mensaje Verificación fallida indica la ruta y ambos tipos, por ejemplo una cadena que volvió como fecha. Cambia el Analizador de destino a Portable.

Preguntas frecuentes

¿Cómo convierto JSON a YAML?

Pega tu JSON en el convertidor de JSON a YAML, elige un Analizador de destino (Portable es el valor por defecto) y pulsa Convertir a YAML. Después descarga el archivo .yaml o cópialo. Gratis admite un archivo de hasta 10 MB.

¿Cómo convierto YAML a JSON?

Pega YAML o suelta un archivo .yaml o .yml en el convertidor de YAML a JSON. Elige la sangría, cómo tratar varios documentos y si ordenar las claves, y descarga el resultado. Gratis admite un archivo de hasta 25 MB.

¿Qué es el problema de Noruega en YAML?

En YAML 1.1 la palabra no sin comillas es un booleano, así que el código de país NO de Noruega se lee como false. Entrecomillar el valor lo soluciona. El convertidor de JSON a YAML lo hace por ti cuando el Analizador de destino es Portable.

¿Se conservan los comentarios al convertir YAML a JSON?

No. JSON no tiene comentarios, así que se descartan todos los comentarios con #. Conserva el YAML como fuente y genera el JSON a partir de él, en lugar de editar el JSON a mano.

¿Por qué mi YAML falla con un error de tabulador?

YAML no permite tabuladores en la sangría, aunque el archivo parezca alineado en tu editor. Sustituye los tabuladores por espacios. El convertidor de YAML a JSON indica la línea y la columna en que se detuvo.

¿Puedo convertir archivos de Kubernetes o Docker Compose?

Sí. Un manifiesto con varios documentos separados por --- se convierte en un array, en su primer documento o en un archivo por documento. Los anclajes, alias y claves de combinación se resuelven. Todo se ejecuta en tu dispositivo, no en nuestros servidores, así que los nombres de host y de imágenes no se suben.

Sigue leyendo

Más sobre Documentos →