Cómo convertir JSON a YAML

Qué puedes hacer con la herramienta

Esta herramienta transforma texto JSON válido en texto con formato YAML. Puede servirte cuando recibes una configuración, una respuesta de API o un archivo de datos en JSON y necesitas revisarlo o utilizarlo en un contexto donde YAML resulte más cómodo de leer. Admite objetos, objetos anidados y listas, y genera YAML con estilo de bloques. Las cadenas que puedan confundirse con elementos propios de YAML pueden aparecer entre comillas, mientras que las listas con contenido se muestran con marcadores de lista.

No necesitas proporcionar una entrada para obtener una conversión correcta: el campo de JSON es opcional y, si está vacío o solo contiene espacios, el resultado es un texto YAML vacío. Para una conversión normal, introduce un JSON válido. También puedes ajustar la sangría y decidir si quieres ordenar las claves de los mapas; la sangría predeterminada es de 2 espacios y la ordenación está desactivada de forma predeterminada.

Pasos para convertir JSON a YAML

1. Prepara el contenido de origen como texto JSON. Comprueba que los nombres de las propiedades estén entre comillas dobles, que las cadenas también lo estén y que los objetos y las listas utilicen una sintaxis válida. Si dejas el campo vacío, la herramienta acepta la entrada y devuelve YAML vacío.

2. Pega el JSON en el campo de entrada. Puedes usar un objeto sencillo, objetos anidados o una lista. No introduzcas texto con otro formato esperando que se interprete como JSON.

3. Ajusta la sangría numérica si necesitas una presentación distinta de la predeterminada de 2 espacios. Esta opción afecta a la organización visual del YAML resultante.

4. Activa la preferencia de ordenación de claves si quieres que las claves de los mapas se ordenen. Si no la activas, la ordenación está deshabilitada de forma predeterminada.

5. Ejecuta la conversión y revisa el texto YAML generado. En el resultado, los objetos se expresan con bloques, las listas no vacías utilizan marcadores y algunos valores de texto pueden quedar entre comillas para conservar un significado válido en YAML.

6. Si no se produce YAML, vuelve al texto de entrada y corrige la sintaxis JSON. Una entrada que no sea JSON válido hace que la conversión no tenga éxito; una incidencia durante la serialización también se devuelve como resultado no satisfactorio.

Cómo leer el resultado y sus límites

Un resultado satisfactorio indica que el texto JSON proporcionado se ha convertido a texto YAML. La forma de bloques facilita la lectura de jerarquías y las listas con contenido se reconocen por sus marcadores. Si conservas caracteres Unicode en el JSON, el YAML puede mantenerlos, aunque ciertos contenidos con significado especial para YAML pueden aparecer entre comillas.

La sangría y el orden de las claves son preferencias de presentación: la primera tiene un valor predeterminado de 2 y la segunda empieza desactivada. Un resultado vacío también puede ser correcto cuando la entrada estaba vacía o solo contenía espacios, por lo que no debes interpretarlo automáticamente como un fallo.

La herramienta trabaja sobre texto JSON válido. No hay base para asumir que acepta texto arbitrario, que valida un esquema, que normaliza los datos o que conserva cada detalle de formato del texto original. Si la entrada no es válida o falla la serialización, el resultado se marca como no satisfactorio y no se produce texto YAML.

Ejemplo práctico

Una persona recibe una configuración breve en JSON y quiere leer sus propiedades y etiquetas con la sintaxis de bloques de YAML.

Pega el JSON {"nombre":"Ana","etiquetas":["web","datos"]}, deja la sangría predeterminada y ejecuta la conversión. Después, comprueba que el resultado muestra las propiedades en bloques y las dos etiquetas como elementos de una lista.

El resultado tiene formato YAML de bloques: el objeto conserva sus propiedades y la lista no vacía aparece mediante marcadores de lista.

Limitaciones

• La conversión depende de que la entrada sea JSON válida; si la sintaxis no es válida o falla la serialización, el resultado es no satisfactorio y no se genera texto YAML.

Errores frecuentes

• Si pegas JSON con comillas simples, una coma sobrante o una propiedad sin comillas dobles, la entrada deja de ser JSON válido. Corrige la sintaxis y vuelve a ejecutar la conversión.

Preguntas frecuentes

¿Puedo convertir un JSON con objetos anidados y listas?

Sí, siempre que el contenido sea JSON válido. Se admiten objetos, objetos anidados y listas; si el campo está vacío o solo contiene espacios, la conversión termina correctamente con YAML vacío.

¿Puedo cambiar la sangría y ordenar las claves?

Sí. Puedes indicar una sangría numérica distinta de la predeterminada de 2 espacios y activar la preferencia para ordenar las claves de los mapas. La ordenación comienza desactivada.

¿Qué ocurre si el JSON contiene un error de sintaxis?

No, si el texto no es JSON válido. En ese caso la conversión no tiene éxito y no se produce texto YAML; revisa las comillas, las comas y la estructura antes de volver a intentarlo.