Seleccionar idioma

Conversor de YAML a JSON online

Transforma archivos YAML basados en indentación a JSON estándar con llaves, comillas y comas, ideal para API y código que prefieren JSON.

Mehmet Demiray Publicado Actualizado
Compartir
Expande las claves de fusión de YAML (<<) en el mapeo
Espaciado usado para formatear la salida JSON

Qué es la conversión de YAML a JSON

YAML y JSON son dos formas de representar los mismos datos estructurados, pero con filosofías distintas. YAML usa la indentación y los saltos de línea para marcar la jerarquía, lo que lo hace muy cómodo de leer y editar a mano; por eso domina en archivos de configuración. JSON emplea llaves, corchetes, comillas y comas, una sintaxis más verbosa pero que prácticamente cualquier lenguaje de programación y API entiende de forma nativa. Convertir de YAML a JSON significa traducir esa estructura basada en espacios a la notación explícita de JSON sin alterar el contenido. Necesitas este paso cuando un archivo escrito en YAML, pensado para que lo lean personas, debe consumirse desde código o enviarse a un servicio que solo acepta JSON. La conversión no cambia el significado de los datos: una lista sigue siendo una lista y un valor numérico sigue siendo numérico. Simplemente cambia la forma en que se escriben. En la práctica, dispones así de un formato cómodo para editar y otro listo para integrar, y conviertes entre ellos según la etapa del trabajo.

Cómo funciona el conversor

El conversor trabaja en dos fases: analiza el YAML de entrada y genera el JSON equivalente. Primero interpreta la indentación para deducir la jerarquía, distingue entre mapas y listas e identifica cada par de clave y valor. Después produce la sintaxis de JSON, encerrando los textos entre comillas, los objetos entre llaves y las listas entre corchetes. Mira cómo un fragmento sencillo de YAML se transforma en JSON:

`` nombre: Ana edad: 30 ``

se convierte en:

`` { "nombre": "Ana", "edad": 30 } ``

La herramienta maneja las características avanzadas de YAML, como las anclas y los alias para reutilizar bloques, las cadenas multilínea y las estructuras profundamente anidadas. Los pasos para usarla son directos:

  1. Pega tu contenido YAML en el campo de entrada.
  2. Revisa que la indentación sea coherente.
  3. Obtén el JSON válido y cópialo.

Una vez convertido, puedes pasar el resultado por el formateador de JSON para indentarlo y revisarlo con comodidad antes de integrarlo en tu proyecto.

Para qué sirve en la práctica

Convertir YAML a JSON resuelve necesidades muy comunes en el desarrollo y la gestión de datos. El caso más habitual es preparar archivos de configuración para su uso programático: muchas herramientas se configuran en YAML por comodidad, pero el código que los lee suele trabajar mejor con JSON. También es clave al preparar datos para API REST, ya que la mayoría de los servicios web esperan recibir y devolver JSON, no YAML. En proyectos que migran entre formatos de configuración, el conversor actúa de puente para no reescribir todo a mano. Otro uso frecuente es la depuración: ver el equivalente en JSON de un YAML ayuda a detectar errores de indentación o estructuras mal formadas que pasan desapercibidas en el original. Una vez en JSON, también puedes seguir transformando los datos, por ejemplo al formato compacto con el conversor de JSON a YAML en el sentido inverso, o compararlo con archivos provenientes de otras fuentes. En definitiva, esta conversión te da flexibilidad para mover la misma información entre el formato que prefieres editar y el que tus sistemas necesitan consumir.

Diferencias clave entre YAML y JSON

Aunque ambos describen datos estructurados, YAML y JSON difieren en aspectos que conviene conocer antes de convertir. YAML se apoya en la indentación, admite comentarios y ofrece funciones avanzadas como anclas y alias, lo que lo hace muy expresivo para configuración. JSON es más estricto y minimalista: no admite comentarios y exige una sintaxis rígida de llaves y comillas, pero a cambio goza de soporte universal. Esta tabla resume el contraste:

Aspecto YAML JSON
Estructura Indentación Llaves y corchetes
Comentarios No
Legibilidad Muy alta Media
Compatibilidad Amplia Universal

Al convertir, ten en cuenta que los comentarios del YAML se pierden, porque JSON no los admite. Las anclas y los alias se resuelven y se expanden en sus valores reales. La indentación deja paso a una sintaxis explícita. Comprender estas diferencias evita sorpresas: si tu YAML depende de comentarios para documentarse, guárdalos aparte, ya que no aparecerán en el JSON resultante. Por lo demás, la información estructural se conserva por completo.

Casos límite y fidelidad de la conversión

La conversión de YAML a JSON es sin pérdidas en cuanto a los datos, aunque hay matices que conviene vigilar. Los comentarios del YAML no sobreviven, porque JSON no los contempla; si los necesitas, consérvalos por separado. Las cadenas multilínea, que YAML expresa con bloques especiales, se convierten en un único texto con saltos de línea escapados dentro del JSON. Las anclas y los alias se resuelven, de modo que el bloque reutilizado aparece repetido y expandido en cada punto donde se usaba. Presta atención a los valores ambiguos: en YAML, palabras como yes, no, on u off pueden interpretarse como booleanos según la versión, así que revisa que se conviertan como esperas. Lo mismo ocurre con números que empiezan por cero o con fechas. Para asegurar la fidelidad, comprueba siempre que la indentación del YAML de entrada sea coherente, ya que un solo espacio de más altera la jerarquía. Si el resultado no cuadra, el problema casi siempre está en un YAML de partida ambiguo o mal indentado, y no en la conversión en sí misma.

Las que respondemos con más frecuencia.

¿Cómo convierto YAML a JSON?

Pega tu contenido YAML en el campo de entrada y asegúrate de que la indentación sea coherente. La herramienta analizará la estructura y generará el JSON equivalente con sus llaves, comillas y comas. Después solo tienes que copiar el resultado y usarlo en tu código, tu API o el sistema que lo necesite.

¿Cuáles son las diferencias clave entre YAML y JSON?

YAML usa la indentación para marcar la jerarquía, admite comentarios y resulta muy cómodo de leer, por eso domina en configuración. JSON emplea llaves y corchetes, no admite comentarios y tiene una sintaxis más rígida, pero goza de soporte universal en lenguajes y API. Ambos representan los mismos datos de forma distinta.

¿Qué ocurre con las estructuras anidadas o los caracteres especiales?

Las estructuras anidadas se conservan siempre que la indentación del YAML sea coherente. Los caracteres especiales y las cadenas multilínea se escapan correctamente dentro del JSON resultante. Las anclas y los alias se resuelven, de modo que el bloque reutilizado aparece expandido en cada lugar donde se empleaba.

¿La conversión es sin pérdidas?

En cuanto a los datos, sí: el JSON resultante representa la misma información que el YAML de partida. La única excepción son los comentarios, que JSON no admite y por tanto se pierden. Si los necesitas, consérvalos aparte antes de convertir. El resto de la estructura se mantiene intacta.

¿Maneja anclas, alias y cadenas multilínea de YAML?

Sí. La herramienta resuelve las anclas y los alias expandiendo el bloque reutilizado en cada punto donde aparece. Las cadenas multilínea se convierten en un único texto con sus saltos de línea escapados. También admite estructuras profundamente anidadas, de modo que cubre las características avanzadas más habituales de YAML.