Convertir JSON a YAML JavaScript Object Notation ↔ YAML Ain't Markup Language Gratis En línea Seguro

Por qué la gente convierte JSON a YAML

JSON es la notación que los programas adoran: estricta, compacta y entendida por todos los lenguajes. Pero no es amable con las personas. Un archivo JSON largo es una maraña de llaves, corchetes, comillas y comas, sin lugar para un comentario y con una coma final que puede estropearlo todo. YAML es la notación que eligen las personas cuando deben leer y editar datos a mano. Usa sangrías en lugar de llaves, admite comentarios y se lee casi como un esquema, por lo que se convirtió en el favorito para la configuración: canalizaciones de compilación, definiciones de contenedores, archivos de despliegue, ajustes de sitios estáticos y herramientas de documentación. Cuando los datos llegan como JSON y quiere trabajar con ellos en una forma agradable de leer, hace falta una conversión. Por eso la gente convierte JSON a YAML.

Las situaciones son cotidianas. Un desarrollador que tiene la salida de una herramienta en JSON y quiere convertirla en un archivo de configuración. Un equipo que traslada ajustes de un sistema a otro y prefiere un formato legible. Un redactor que quiere leer la estructura de la respuesta de una API sin el desorden. Un estudiante que quiere ver cómo las llaves se traducen en sangrías. En todos los casos los datos son los mismos, y solo cambia la notación.

Esta página convierte JSON a YAML en su navegador. Su archivo se lee y se escribe aquí, de modo que nunca sale de su dispositivo, lo que importa para los archivos de configuración, que a menudo contienen direcciones, nombres de sistemas internos y a veces secretos. Y la página le dice de antemano qué conserva el paso y qué no puede conservar, en lugar de dejar que lo descubra. Más abajo encontrará cómo funciona la conversión, qué ocurre con el anidamiento profundo y las cadenas largas, y cómo obtener un resultado ordenado.

Cómo funciona la conversión

Las mismas formas en ambas notaciones

Su JSON se lee dentro de su navegador, y su estructura se escribe como YAML. Ambos contienen las mismas formas, y se conserva todo en ambos sentidos: mapas, listas, cadenas, números, booleanos y null. Un objeto de JSON se convierte en un mapeo en YAML, una matriz se convierte en una secuencia, y los valores escalares conservan sus tipos. Una clave port con el número 8080 da port: 8080, y una clave enabled con true da enabled: true.

Las estructuras repetidas se escriben enteras

YAML tiene una manera de evitar la repetición, con anclas y alias. El conversor no la usa. Las estructuras repetidas se escriben enteras en lugar de como anclas, de modo que el archivo se lee de arriba abajo. Esto hace el YAML algo más largo, pero nada en él necesita buscarse en otra parte, y cualquier lector puede entender cada bloque por sí solo.

Las claves conservan su orden

Las claves conservan el orden que tenían en JSON. El YAML se lee en la misma secuencia que el original, de modo que quien conozca el JSON encontrará su camino de inmediato.

Qué se conserva

Todo lo que son datos

Se conserva todo, en ambos sentidos: mapas, listas, cadenas, números, booleanos y null. Si era un valor en su JSON, es un valor en el YAML, con el mismo tipo.

Cadenas que necesitan protección

Algunas cadenas se leerían mal en YAML si se escribieran sin más: la palabra true, un número entre comillas, un texto que contiene dos puntos. El conversor entrecomilla esas cadenas para que vuelvan como cadenas y no se conviertan en booleanos ni en números. Una cadena JSON que dice «true» sigue siendo una cadena en el YAML.

Unicode

Las letras con acento, los símbolos y los caracteres de otros alfabetos se conservan tal cual, de modo que un archivo en varios idiomas sigue siendo legible.

Lo que debe saber antes de convertir JSON a YAML

Anidamiento profundo significa sangría profunda

YAML pone el significado en su sangría, así que un valor que acaba muy anidado se convierte en un archivo muy sangrado: legible, pero no corto. Un árbol JSON de ocho niveles da líneas que empiezan lejos del margen izquierdo. Si eso se vuelve incómodo, considere aplanar la estructura en su origen.

Las cadenas largas se parten

Las cadenas largas se parten a unas cien columnas, lo que cambia dónde caen los saltos de línea sin cambiar el valor. Un párrafo que era una sola línea larga en el JSON aparece en varias líneas en el YAML, pero es el mismo texto. Un programa que lee el YAML recibe la cadena original.

Los comentarios no pueden inventarse

YAML admite comentarios, pero JSON no lleva ninguno, así que el resultado no tiene ninguno. Puede añadir explicaciones a mano después, que es una de las razones principales para tener el archivo en YAML.

Cómo convertir JSON a YAML aquí

Añada su archivo

Suelte el archivo JSON sobre la página o elíjalo en su dispositivo. Se lee dentro de su navegador y no se sube.

Convierta

Pulse el botón. Un archivo de tamaño corriente lleva un momento. Deje la página abierta hasta que termine.

Descargue y compruebe

Descargue el YAML y ábralo en un editor de texto. Mire el principio y el final, y compruebe que la estructura y los tipos son los que espera.

Una mirada más de cerca a JSON y YAML

Dos notaciones para los mismos datos

JSON se diseñó para que fuera fácil de leer y escribir para los programas. YAML se diseñó para que fuera fácil para las personas. Coinciden hasta tal punto que JSON es casi un subconjunto de YAML, y un lector de YAML suele poder leer JSON. Convertir JSON a YAML no es, por tanto, cambiar los datos sino volver a vestirlos, en una forma que tiene sitio para notas y carece del desorden de la puntuación.

Por qué la sangría requiere cuidado

Como YAML depende de la sangría, una línea desalineada cambia el significado. El conversor escribe la sangría con coherencia, con espacios y con el mismo ancho en cada nivel, de modo que el archivo es correcto tal como se produce. Cuando lo edite más tarde, mantenga el mismo ancho, y evite los tabuladores, que YAML no permite para la sangría.

Legible pero no siempre más corto

A menudo se describe YAML como más compacto que JSON, porque suprime las llaves y las comillas alrededor de las claves. Para datos planos esto es cierto. Para datos muy anidados, la sangría puede hacerlo más largo en caracteres. La ganancia está en la legibilidad, no en el tamaño.

Situaciones comunes en detalle

Convertir la salida de una herramienta en configuración

Las herramientas suelen imprimir sus ajustes o resultados como JSON. Convierta JSON a YAML, añada comentarios y conserve el resultado como el archivo de configuración que mantienen las personas.

Trasladar ajustes entre sistemas

Trasladar una configuración de un sistema que usa JSON a uno que usa YAML es cuestión de una conversión, seguida de una comprobación de que el destino acepta las claves.

Leer la respuesta de una API

La respuesta de una API puede llegar a cientos de líneas de llaves. En YAML, los mismos datos se leen como un esquema, y puede ver la estructura de un vistazo.

Enseñanza y documentación

Mostrar los mismos datos en ambas notaciones es una buena manera de enseñar cómo funcionan los datos estructurados. La documentación que usa ejemplos en YAML suele ser más fácil de leer.

Consejos prácticos antes de convertir JSON a YAML

Compruebe que el JSON es válido

Una coma suelta o una comilla ausente detendrán la conversión. Si la página informa de un error, abra el archivo en un editor que resalte los problemas de JSON y corrija la línea que señala.

Aplane donde pueda

Si la estructura es más profunda de lo necesario, simplifíquela primero. Una estructura más plana da un YAML más fácil de leer y de editar.

Piense en el consumidor

Mire qué leerá el YAML. Algunas herramientas esperan nombres de clave y tipos particulares, y es más fácil ajustar el JSON de antemano que editar el YAML después.

Archivos grandes

Todo se ejecuta en su dispositivo, así que un archivo muy grande necesita memoria. Para archivos de muchos megabytes, use un ordenador, y divida los datos si la página tiene dificultades.

Preguntas que la gente se hace antes de convertir

¿Se modificarán mis datos?

No. Se conserva todo en ambos sentidos: mapas, listas, cadenas, números, booleanos y null.

¿Por qué se parten mis cadenas largas en varias líneas?

Las cadenas largas se parten a unas cien columnas. Esto cambia dónde caen los saltos de línea sin cambiar el valor.

¿Por qué tiene tanta sangría mi archivo?

Porque los datos están muy anidados, y YAML expresa el anidamiento mediante la sangría.

¿Dónde están las anclas?

Las estructuras repetidas se escriben enteras en lugar de como anclas, de modo que el archivo se lee de arriba abajo.

¿Se sube mi archivo?

No. La conversión se ejecuta en su navegador y el archivo nunca sale de su dispositivo.

¿Puedo volver a JSON?

Sí. YAML a JSON vuelve a leer el archivo, aunque los comentarios que haya añadido no sobrevivirán.

Elegir con acierto al convertir JSON a YAML

¿Hace falta realmente YAML?

Si la herramienta receptora lee JSON, conserve el JSON. Convierta cuando las personas deban leer y editar el archivo, o cuando la herramienta exija YAML.

Otros destinos

Si el destino es un archivo de marcado, puede seguir JSON a XML. Para tablas, JSON a CSV y JSON a XLSX sirven a las hojas de cálculo.

Conserve el JSON

El JSON es el original maestro si procede de un programa. Consérvelo, y vuelva a generar el YAML cuando cambie.

Lograr un buen resultado tras la conversión

Añada comentarios

El resultado no tiene ninguno, y aquí es donde YAML brilla. Añada una breve nota sobre cada bloque para decir qué hace y qué valores se permiten.

Compruebe los tipos

Mire valores como versiones, códigos e indicadores. Asegúrese de que son cadenas donde quería cadenas y números donde quería números.

Mantenga la sangría coherente

Cuando edite, use espacios y mantenga el mismo ancho en cada nivel. Un editor que muestre los espacios en blanco y compruebe YAML le ahorrará errores.

Preparar su JSON para que se convierta bien

Manténgalo regular

Al convertir JSON a YAML, los datos regulares son los que mejor se convierten: claves coherentes y tipos claros. Los datos irregulares dan un resultado correcto pero desordenado.

Ponga nombres claros a las claves

Las personas leerán el YAML, así que elija claves que digan lo que significan. Una configuración es más fácil de mantener cuando sus nombres son sencillos.

Pruebe primero con un trozo pequeño

Si su archivo es grande, lleve una sección a un archivo de prueba y convierta ese. Un vistazo rápido al resultado muestra si la estructura es la que espera.

Trabajar con el YAML después de convertir JSON a YAML

Añada las notas que JSON no podía contener

Lo primero que hay que hacer con un archivo recién convertido es leerlo desde arriba y añadir comentarios donde un extraño se quedaría perplejo. Una breve línea sobre una sección que diga qué controla vale más que una página de documentación guardada en otra parte, porque está junto a lo que describe. Esta es la principal ventaja que gana al convertir JSON a YAML.

Agrupe los ajustes relacionados

Las claves conservan el orden que tenían en el JSON, que puede ser el orden en que un programa las emitió por casualidad. En YAML es libre de reordenarlas para que los ajustes relacionados queden juntos, con una línea en blanco entre los grupos. Como el orden de las claves en un mapeo no tiene significado para la mayoría de los lectores, es seguro, pero compruebe la herramienta que usa por si le importa.

Compruebe lo que espera la herramienta receptora

Un archivo YAML válido no es necesariamente una configuración válida. Las herramientas esperan claves y tipos particulares, y algunas son estrictas con las claves desconocidas. Tras la conversión, compare el archivo con la documentación de la herramienta, y ejecute su propio verificador si lo tiene.

Use control de versiones

La configuración en YAML es fácil de comparar línea a línea, lo que la hace muy adecuada para el control de versiones. Confirme el archivo convertido y deje que los colegas vean cada cambio como una diferencia clara, lo que era mucho más difícil con una sola línea de JSON minificado.

Cuidado con los secretos

El JSON exportado desde herramientas a veces incluye tokens y contraseñas. Como la conversión ocurre en su navegador, nada sale de su dispositivo, pero el archivo YAML contendrá los mismos secretos. Elimínelos, o llévelos a un lugar más seguro, antes de confirmar o compartir el archivo.

Vigile la sangría al editar

Una vez que empieza a editar a mano, el principal riesgo es una línea desplazada un espacio. Use un editor que muestre los espacios en blanco y compruebe YAML mientras escribe, y mantenga el mismo ancho en cada nivel, como hizo el conversor.

Vuelva a convertir cuando cambie el origen

Si el JSON lo produce un programa y cambia de vez en cuando, vuelva a convertir JSON a YAML para cada nueva versión, y fusione sus comentarios del archivo antiguo en el nuevo. Una herramienta de comparación lo reduce a cuestión de minutos.

Privacidad y manejo

Por qué importa la conversión local para la configuración

Los archivos de configuración suelen contener direcciones, nombres de sistemas internos y a veces claves y contraseñas. Muchos conversores en línea suben su archivo a un servidor, lo procesan y devuelven el resultado, y durante un tiempo una copia vive en una máquina que usted no controla. Aquí su propio navegador hace el trabajo, así que el archivo se queda en su dispositivo.

Qué ocurre cuando se va

Cuando cierra la página, el archivo convertido desaparece del navegador, así que descárguelo primero. No se conserva nada de su archivo.

Si algo sale mal

La página dice que el archivo no es JSON válido

Puede haber una coma suelta, una comilla ausente o un corchete que no se cierra. Abra el archivo en un editor que resalte los errores de JSON y corrija la línea que señala.

La herramienta rechaza el YAML

Compruebe los nombres de clave y los tipos que espera. El YAML es válido, pero la herramienta puede querer nombres distintos o una estructura diferente.

La página se congela con un archivo grande

Todo se ejecuta en su dispositivo, y un archivo grande necesita memoria. Inténtelo de nuevo en un ordenador, o divida los datos.

Herramientas relacionadas

La misma familia de herramientas cubre los trabajos vecinos. Para volver atrás, use YAML a JSON. Para marcado, JSON a XML y XML a JSON convierten entre esos dos. Para tablas, están JSON a CSV, CSV a JSON, JSON a XLSX y XLSX a JSON.

Un ejemplo resuelto

Digamos que una herramienta imprime sus ajustes como un archivo JSON de 150 líneas, y quiere conservarlos en su repositorio como una configuración que los colegas puedan leer y comentar. Suelta aquí el archivo y pulsa el botón. Un momento después descarga un YAML de unas 90 líneas en el que la estructura se lee como un esquema. Añade un comentario sobre cada sección, lo confirma y dice al equipo dónde editar. El JSON sigue siendo la salida de la herramienta.

Una breve lista de comprobación

Antes de convertir

Compruebe que el JSON es válido. Simplifique el anidamiento profundo si puede. Conserve el JSON.

Mientras convierte

Quédese en la página hasta que el archivo esté listo.

Después de convertir

Abra el YAML, compruebe la estructura y los tipos, añada comentarios y pruébelo con la herramienta que lo leerá.

Errores comunes

Esperar un archivo más corto

El anidamiento profundo produce una sangría profunda. YAML es más legible, no siempre más pequeño.

Editar con tabuladores

YAML no permite tabuladores para la sangría. Use espacios.

Perder el original

Si el JSON procede de un programa, consérvelo y vuelva a generar el YAML cuando cambie.

Su archivo se queda en su dispositivo

La conversión ocurre en local. Su archivo lo lee su propio navegador, se reescribe allí y se le devuelve como YAML. No se sube nada, así que no queda ninguna copia en un servidor y nadie más puede leerlo. Para una configuración de contenido privado, esa es la forma segura de convertir JSON a YAML.

Resumen

Para convertir JSON a YAML aquí, suelte el archivo y pulse el botón. Se lee y se escribe en su navegador, de modo que el archivo nunca sale de su dispositivo. Se conserva todo, en ambos sentidos: mapas, listas, cadenas, números, booleanos y null. Las estructuras repetidas se escriben enteras en lugar de como anclas, de modo que el archivo se lee de arriba abajo. YAML pone el significado en su sangría, así que un valor que acaba muy anidado se convierte en un archivo muy sangrado, legible pero no corto. Las cadenas largas se parten a unas cien columnas, lo que cambia dónde caen los saltos de línea sin cambiar el valor. Las claves conservan el orden que tenían en JSON.