Cómo convertir YAML a JSON con sangría configurable

Cuándo usar la conversión

Esta herramienta sirve para transformar texto YAML en texto JSON cuando necesitas cambiar de formato para revisar datos, preparar una configuración o intercambiar información con otra aplicación. Puedes trabajar con mapas, mapas anidados y secuencias, porque el contenido YAML se analiza y después se serializa como JSON. El resultado es texto JSON; no se trata de una conversión de JSON a YAML ni de una copia literal de la presentación original del YAML.

Pasos para convertir YAML a JSON

Introduce el contenido YAML en el campo de entrada. Si lo dejas vacío o solo contiene espacios, la conversión se completa y devuelve un objeto JSON vacío.
Revisa la configuración de la salida. Puedes elegir la sangría del JSON; el valor predeterminado es 2. También puedes activar la ordenación de las claves de los objetos si necesitas una salida más uniforme para comparar resultados. La ordenación está desactivada de forma predeterminada.
Inicia la conversión y revisa el texto JSON generado. Comprueba que las estructuras anidadas y las secuencias aparecen con la forma esperada. Si el YAML tiene un error de sintaxis, la conversión no termina con una salida JSON válida.
Si el texto comienza, después de quitar los espacios iniciales, por --- y contiene una nueva línea seguida de otro ---, se procesa como varios documentos. Los documentos que representan un valor nulo se eliminan. Cuando quedan varios documentos no nulos, el resultado es un array JSON; si queda uno, se devuelve ese documento, y si no queda ninguno, se devuelve un objeto JSON vacío.
Usa la salida JSON en el siguiente paso de tu flujo y conserva por separado el YAML original si necesitas consultar sus comentarios, comillas o disposición visual, ya que la herramienta analiza los valores y genera texto JSON en lugar de mantener esa presentación.

Cómo leer el resultado y sus límites

Un objeto YAML sencillo suele producir un objeto JSON. Los mapas anidados siguen siendo objetos anidados y las secuencias se serializan como arrays. La sangría cambia la legibilidad del texto, no el tipo de estructura que representan los datos. Ordenar las claves puede modificar su orden en la salida, pero no convierte el contenido en otro formato.

Una entrada vacía tiene un tratamiento específico: el resultado es un objeto JSON vacío, no un fallo. En cambio, un YAML mal formado produce un resultado no satisfactorio. También puede producirse un resultado no satisfactorio si el valor obtenido tras analizar el YAML no se puede serializar como JSON. Por eso conviene revisar primero la sintaxis y después validar que los valores empleados sean adecuados para JSON.

Ejemplo práctico

Una persona necesita entregar una configuración escrita en YAML a un sistema que espera texto JSON y quiere conservar la estructura de un mapa anidado junto con una secuencia.

Introduce el texto YAML con las propiedades usuario y etiquetas, selecciona la sangría disponible y ejecuta la conversión. Revisa que usuario aparezca como objeto anidado y etiquetas como array en el texto JSON.

La salida tiene forma de objeto JSON con una propiedad anidada y una propiedad cuyo valor es un array; la sangría visible depende de la configuración elegida.

Limitaciones

La conversión no produce una salida JSON satisfactoria cuando el YAML está mal formado o cuando el valor analizado no se puede serializar como JSON.

Errores frecuentes

Si la conversión falla, la causa puede ser una estructura YAML mal formada. Corrige la indentación, los separadores o la sintaxis de la entrada y vuelve a iniciar la conversión.

Preguntas frecuentes

¿Puede convertir YAML anidado y listas a JSON?

Sí, si introduces YAML con mapas, mapas anidados o secuencias, la herramienta analiza esas estructuras y las serializa como JSON. El resultado se entrega como texto JSON.

¿Qué ocurre si no introduzco ningún YAML?

Si la entrada está vacía o solo contiene espacios, la conversión se completa y devuelve un objeto JSON vacío.

¿Cómo se comporta con varios documentos YAML?

La entrada se trata como varios documentos cuando, tras quitar los espacios iniciales, empieza por --- y contiene una nueva línea seguida de otro ---. Después se eliminan los documentos nulos: si quedan varios, la salida es un array JSON; si queda uno, se devuelve ese documento.