Conversor YAML a JSON

1. 1

   Pega o suelta tu YAML

   Pega en el editor, arrastra un archivo .yaml o .yml a la zona de carga, o abre uno de los tres ejemplos. La conversión ocurre mientras escribes: no hay que pulsar nada para ver el resultado.

2. 2

   Elige la forma de salida

   2 espacios, 4 espacios, tabulaciones o minificado. Si el archivo contiene varios documentos separados por ---, decide si se convierten en un array JSON, solo el primero, o un archivo cada uno. Activa Ordenar claves cuando la salida vaya a compararse.

3. 3

   Revisa qué cambió la conversión

   El panel bajo el resultado nombra todo lo que JSON no puede llevar igual: valores como .nan y .inf, datos binarios escritos como base64, y etiquetas como !Ref resueltas al valor de debajo. Nada cambia en silencio.

4. 4

   Convierte, después descarga o copia

   Pulsa Convertir para generar los archivos, y después descarga el .json, cópialo al portapapeles, o llévate un lote entero como un solo ZIP. Si el YAML no se puede leer, el error indica la línea, la columna y el texto alrededor.

Pega YAML, suelta un archivo .yaml o .yml, o carga un ejemplo, y el JSON aparece mientras escribes. Los manifiestos de varios documentos, las claves de fusión, las anclas y las etiquetas poco habituales se procesan en vez de rechazarse, y todo lo que la conversión tuvo que cambiar se cuenta bajo el resultado en lugar de ocurrir en silencio. Elige 2 espacios, 4 espacios, tabulaciones o minificado, ordena las claves cuando el archivo vaya a compararse, y descarga el .json o cópialo.

• YAML 1.2 core — Mapas, secuencias, estilos de bloque y de flujo, escalares multilínea, anclas, alias y claves de fusión. Las reglas de escalares son las del esquema core 1.2, así que yes y no siguen siendo texto.
• Consciente de varios documentos — Un manifiesto separado por --- se convierte en un array JSON, en su primer documento, o en un archivo por documento. La versión anterior de esta herramienta rechazaba esos archivos.
• Cuatro formas de salida — 2 espacios, 4 espacios, tabulaciones reales, o minificado en una línea. Ordenar claves deja cada objeto en un orden estable para que dos conversiones de los mismos datos se comparen limpiamente.
• Errores con posición — El mensaje, la línea, la columna y tres líneas de tu propio origen con un cursor bajo el fallo, no un número extraído de una frase.
• Nada cambia en silencio — Los números no finitos, los datos binarios y las etiquetas resueltas se cuentan y se nombran bajo el resultado, porque cada uno es un valor que JSON no puede llevar igual.
• Lotes y ZIP — Encola hasta 50 archivos con Pro, llévatelos como un solo archivo comprimido, o pliega todos los documentos de todos los archivos en un único array JSON.

Un archivo YAML puede contener varios documentos separados por tres guiones en su propia línea. Es la forma normal de un manifiesto de Kubernetes — un Namespace, un Deployment y un Service en un archivo — y también es como escriben su salida kubectl, kustomize y helm template. JSON no tiene un separador equivalente, así que un conversor tiene que decidir algo, y rechazar el archivo es la decisión que toman casi todos.

• Automático — Un documento se convierte en un objeto; varios, en un array de objetos. Es lo que la gente espera y es el valor predeterminado.
• Siempre array — Siempre un array, incluso con un solo documento. Úsalo cuando lo que lea el JSON itere sin comprobar y un objeto suelto lo rompa.
• Solo el primer documento — Toma el documento inicial y descarta el resto. Útil cuando a un archivo se le ha concatenado algo y solo necesitas la cabeza.
• Archivos separados — Un .json por documento, numerado con ceros a la izquierda para que un listado de carpeta ordene igual que el original. Ninguno de los competidores de esta página lo ofrece.
• Los documentos vacíos cuentan — Una serie de --- sin nada entre las marcas es una serie de documentos null, y se conservan en vez de descartarse, porque sus posiciones significan algo en un parche.

YAML permite nombrar un nodo con &ancla y referirse a él después con *alias, y permite que un mapa absorba otro con la clave de fusión <<. Entre los dos son la forma en que los archivos docker-compose, las canalizaciones de GitLab CI y los valores de Helm evitan repetirse. JSON no tiene nada de esto, así que cada referencia debe expandirse en su sitio, y cómo trate un conversor la clave de fusión es la diferencia entre un resultado correcto y uno plausible pero equivocado.

• Los alias se expanden — Cada nodo referenciado se escribe allí donde se usa. Dos alias a la misma ancla producen dos subárboles idénticos en el JSON, porque JSON no puede expresar que eran el mismo nodo.
• Las claves de fusión se resuelven — Un servicio escrito como <<: *common sale con las claves compartidas incorporadas. Un parser que siga YAML 1.2 al pie de la letra deja en su lugar una clave literal "<<" con un objeto anidado: JSON válido, datos incorrectos, y ningún error.
• Ganan las claves posteriores — Las claves escritas directamente en el mapa sobrescriben las que fusionó, que es el comportamiento del que dependen docker-compose y GitLab CI.
• La expansión está acotada — Las anclas pueden anidarse de forma que un archivo diminuto se expanda a gigabytes. La expansión posible se mide antes de analizar nada, y un archivo que pueda superar el presupuesto se rechaza en milisegundos en vez de congelar la página.

Las reglas de escalares son las del esquema core de YAML 1.2, y difieren de YAML 1.1 justo donde se decide si un valor llega como texto o como número. Equivocarse aquí no es una diferencia de formato: cambia los datos.

• Los booleanos son solo true y false — yes, no, on, off, y y n siguen siendo texto. Con YAML 1.1 pasarían a booleanos, que es la razón por la que el código de país NO de Noruega ha roto tantas canalizaciones.
• Los números son decimales, octales y hexadecimales — 42, 0o14 y 0x1F son números. 1_000 es texto, porque los separadores con guion bajo son de 1.1; 0b1010 también, por lo mismo.
• Las marcas de tiempo se quedan como se escribieron — 2001-12-14 es la cadena que tecleaste, no una fecha desplazada a la zona horaria de tu máquina. Cambia el ajuste a ISO 8601 si quieres normalizarlas, y el recuento de lo que cambió aparece bajo el resultado.
• Los escalares de bloque conservan sus saltos — Un bloque | conserva cada salto de línea; un bloque > los pliega en espacios. Ambos llegan como cadenas JSON normales con los espacios que describía el YAML.
• Las etiquetas se resuelven al valor de debajo — !Ref, !GetAtt, !Sub y cualquier otra etiqueta poco habitual te dan el escalar, la secuencia o el mapa al que estaban asociadas, y los nombres de etiqueta se listan bajo el resultado.

Parte del YAML no tiene equivalente en JSON. Todo conversor tiene que hacer algo al respecto, y casi todos lo hacen sin decírtelo. Aquí la regla es que nada cambia en silencio: cada uno de estos casos se cuenta, se nombra, y donde hay una elección real es tuya.

• .nan, .inf y -.inf — JSON no tiene literal para ninguno. Por defecto se escribe null y se cuenta cuántos se convirtieron; también pueden escribirse como texto, o puede detenerse la conversión para que decidas en el origen.
• Datos binarios — Un nodo !!binary se convierte en una cadena base64: el mismo texto que había en el YAML, así que no se pierde nada, pero ahora es una cadena y no bytes.
• Claves compuestas — Un mapa o una secuencia usados como clave no tienen equivalente en JSON, así que se representan como texto. La clave se conserva en lugar de convertirse en algo como [object Object], que es lo que produce una conversión ingenua.
• Alias circulares — Un ancla que se refiere a sí misma es YAML legal y JSON imposible. Se informa como alias circular con la ruta al nodo, en vez de fallar dentro de un serializador.
• Comentarios — Los comentarios de YAML no son datos y ningún documento JSON puede guardarlos. Se descartan, como en cualquier conversor: conviene saberlo si los comentarios llevaban la documentación de una configuración.

Los fallos contra los que vale la pena protegerse no son los que dan error. Son los que producen un documento ordenado, plausible e incorrecto. Una clave duplicada es el ejemplo más claro: YAML te permite escribirla, JSON no puede guardar los dos valores, y por tanto uno desaparece en la conversión.

• Rechazar, por defecto — La conversión se detiene y nombra la línea y la columna de la segunda clave. Es el valor predeterminado seguro, porque la alternativa es un archivo que parece convertido y al que le falta un valor.
• O conservar la última — Cambia el ajuste y la conversión termina con «gana la última», que es lo que hace la mayoría de herramientas YAML. La diferencia es que lo elegiste tú.
• El reverso es un tabulador — YAML prohíbe los tabuladores como sangría. Un archivo perfectamente alineado en un editor con tabulación de dos espacios no se analizará, y el error nombra la línea.
• Ordena las claves antes de comparar — Dos exportaciones de los mismos datos pueden diferir solo en el orden de las claves. Ordenar hace que la comparación muestre los cambios y no la ordenación.

Un manifiesto de 25 MB se convierte en poco más de un segundo en la máquina de referencia, y todo el proceso ocurre en tu dispositivo.

• Sangría — 2 espacios, 4 espacios, tabulaciones reales, o minificado en una línea. Las cuatro son gratis: en una sangría no hay eje de calidad.
• Documentos — Automático, siempre array, solo el primer documento, o un archivo por documento.
• Ordenar claves — Ordena las claves de cada objeto por punto de código, igual en todos los idiomas, para que la salida no dependa del idioma del navegador.
• Claves duplicadas — Rechazar e informar, o conservar la última. Este ajuste va al parser, así que cambiarlo vuelve a leer el documento.
• Números no finitos — null, texto, o detener la conversión.
• Marcas de tiempo — Dejarlas exactamente como se escribieron, o normalizarlas a ISO 8601.
• Combinar (Pro) — Todos los documentos de todos los archivos en cola, plegados en un array JSON según el orden de la cola.

YAML lo escriben personas y JSON lo leen programas. La conversión es lo que permite que una configuración cómoda de editar llegue a un sistema que solo acepta JSON, y es la forma más rápida de averiguar qué dice realmente un archivo cuando la sangría deja de ser evidente.

• Las APIs aceptan JSON — Convierte una configuración YAML en un cuerpo de petición, un fixture, o un bloque de ajustes para un servicio que no tiene parser de YAML.
• Depurar la sangría — Cuando un manifiesto no se comporta, convertirlo te muestra la estructura que vio el parser, que a menudo no es la que sugería la sangría.
• Comparar dos configuraciones — Convierte ambas, ordena las claves y compara el JSON. El orden y los cambios de comentarios dejan de aparecer como diferencias.
• Alimentar una cadena JSON — jq, los validadores de JSON Schema y todas las herramientas JSON de este sitio funcionan con el resultado.
• Nada sale de tu dispositivo — Los manifiestos contienen nombres de host, registros de imágenes y de vez en cuando un secreto. La conversión ocurre en la página, así que nada de eso se sube a ninguna parte.

• JSON a YAML
• Formateador JSON
• XML a JSON
• Herramientas JSON
• Validate the JSON

  Confirm the converted document parses everywhere, with the position of anything that does not

• Explore a large result

  A collapsible tree beats scrolling forty thousand lines of a converted manifest