Convertir JSON a YAML
Reescriba JSON como YAML que las personas puedan leer, revisar y comentar. Suba archivos .json y obtenga .yaml con sangría, con las mismas claves, valores y orden, listo para el repositorio.
Convertidor de datos
o suelte aquí archivos CSV, TSV, TXT … ·
Máx. 95 MB por archivo· Hasta 20 archivos· Se borran a los 30 minutos
Los archivos se procesan en nuestros servidores y se borran a los 30 minutos.
Carácter que separa las columnas en archivos CSV y de texto, tanto al leer como al escribir. Automático lo detecta en la entrada y escribe comas.
UTF-8 funciona con cualquier idioma. Elija UTF-8 con BOM si Excel en Windows muestra tildes o caracteres asiáticos ilegibles al abrir el CSV.
Entrada de Excel, ODS y Numbers: convierte solo la primera hoja o todas (un CSV por hoja dentro de un ZIP, o una clave JSON por hoja).
Nombre de la pestaña de la hoja en la nueva hoja de cálculo, de hasta 31 caracteres.
Array de objetos usa los nombres de columna como claves en cada fila; array de arrays es más compacto y conserva el encabezado como primer array.
Nombre del elemento exterior que envuelve todas las filas; cada fila se convierte en un <row> dentro de él.
Se usa en las sentencias CREATE TABLE e INSERT. Solo letras, dígitos y guiones bajos.
Las comillas y los tipos de columna varían un poco entre bases de datos; elija aquella en la que va a importar.
Reescribe las celdas de fecha en un solo formato. ISO (2026-10-18) es el más seguro para bases de datos y código; Mantener sin cambios las deja como aparecen en el original.
Cómo usar esta herramienta
- 1
Agregue los archivos JSON
Suba respuestas de API, configuraciones exportadas o manifiestos generados en .json, hasta 20 archivos de 95 MB cada uno. Cada archivo debe contener un único valor JSON válido.
- 2
Deje los valores predeterminados
YAML ya está seleccionado en Convertir a. Para un archivo de configuración no hace falta cambiar nada más; la salida usa una sangría de dos espacios.
- 3
Convierta y haga commit
Pulse Convertir a YAML, descargue los archivos .yaml, añada comentarios donde el próximo lector los necesite y haga commit.
¿Cómo convierto JSON a YAML?
Suba el archivo .json y pulse Convertir a YAML. Los objetos pasan a bloques clave: valor con sangría, los arrays a listas con guiones, y las cadenas que YAML podría malinterpretar conservan sus comillas.
Por qué convertir JSON a YAML para archivos de configuración
La mayor parte del JSON lo produce el software: una respuesta de API, una exportación de configuración, la salida de un generador. La mayor parte del YAML la mantienen personas. La conversión suele marcar el momento en que los datos dejan de ser salida de una máquina y pasan a ser algo que un equipo gestiona, como un manifiesto de despliegue guardado en Git, un pipeline de CI o un conjunto de variables de Ansible.
Un caso típico: llama a la API de una nube, recibe una descripción JSON de 200 líneas de un recurso y quiere conservarla como infraestructura como código. Al convertir obtiene un archivo sin llaves ni comas, donde un cambio de una línea produce un diff de una línea y puede explicar los valores raros en comentarios. Lo mismo vale para datos de prueba y archivos de traducción que editan personas que no programan. Cuando lo que necesita es una tabla plana, para una hoja de cálculo o un informe, JSON a CSV encaja mejor.
Herramientas cuyos archivos de configuración son YAML
| Organismo | Requisito | Fuente |
|---|---|---|
| GitHub Actions | Los flujos de trabajo están en .github/workflows como archivos .yml o .yaml | Documentación de GitHub |
| GitLab CI/CD | El pipeline se define en .gitlab-ci.yml en la raíz del repositorio | Documentación de GitLab |
| Docker Compose | Los servicios se describen en compose.yaml (antes docker-compose.yml) | Documentación de Docker |
| Ansible | Los playbooks y los archivos de variables se escriben en YAML | Documentación de Ansible |
| Kubernetes | Los manifiestos aceptan JSON o YAML; la documentación y los charts de Helm usan YAML | Sitio de Kubernetes |
Ejemplo de JSON a YAML con valores delicados
nombre: api version: "1.10" depuracion: false etiquetas: - web - eu pais: "NO"
Lo que aporta YAML
- Comentarios con #
- Diffs más cortos en la revisión de código
- Sin llaves, comas ni comillas en la mayoría de las líneas
- Texto de varias líneas con escalares de bloque |
Lo que hay que vigilar
- La sangría tiene significado, así que un espacio de más cambia la estructura
- No se permiten tabulaciones en la sangría
- Las cadenas sin comillas pueden leerse como números o booleanos
- Analizadores más lentos y menos uniformes que los de JSON
El ejemplo muestra por qué no basta con buscar y reemplazar las llaves. La versión 1.10 es una cadena en el JSON; escrita sin comillas en YAML se leería como el número 1.1. NO, el código ISO de Noruega, se leería como false en analizadores YAML 1.1 como PyYAML. Ambos conservan sus comillas, mientras que los números y booleanos auténticos quedan sin ellas.
JSON y YAML comparados
JSON
JavaScript Object Notation (JSON)
JSON es un formato de texto ligero para datos estructurados, popularizado por Douglas Crockford a principios de la década de 2000 y estandarizado como RFC 8259 y ECMA-404. Representa objetos, arreglos, cadenas, números, booleanos y null con una sintaxis sencilla y legible. Es el formato predeterminado para las API web, los archivos de configuración y el intercambio de datos entre aplicaciones en casi todos los lenguajes de programación. No incluye comentarios, fechas ni esquemas, y los archivos grandes y anidados son difíciles de leer sin un visor.
- Compresión
- –
- Transparencia
- –
- Animación
- –
- Presentado en
- 2001 · Douglas Crockford
YAML
YAML
YAML ("YAML Ain't Markup Language") es un formato de datos fácil de leer para las personas, publicado por primera vez en 2001. Usa sangría en lugar de corchetes, admite comentarios y es un superconjunto de JSON. Se usa mucho para la configuración de Docker Compose, Kubernetes, GitHub Actions y numerosas aplicaciones. Como depende de los espacios en blanco, un solo espacio mal colocado puede romperlo, y algunos valores, como "no" o las fechas, pueden interpretarse de forma inesperada.
- Compresión
- –
- Transparencia
- –
- Animación
- –
- Presentado en
- 2001 · Clark Evans, Ingy döt Net, Oren Ben-Kiki
Se convierte JSON a YAML cuando datos generados o de una API tienen que pasar a ser un archivo de configuración que mantienen personas, que se revisa en pull requests y se anota con comentarios.
Preguntas sobre convertir JSON a YAML
¿Un JSON ya es YAML válido?
Con YAML 1.2, sí: la revisión de 2009 se redactó para que todo documento JSON sea también un documento YAML. Podría pegar JSON en un archivo .yaml y la mayoría de las herramientas lo aceptarían. Convertir es cuestión de legibilidad: el estilo de bloque sin llaves, comillas ni comas es lo que esperan los revisores y el próximo responsable.
¿Por qué algunos valores aparecen entre comillas en el YAML convertido desde JSON?
Porque sin comillas YAML los leería como otro tipo. Una cadena de versión como 1.10 se convertiría en el número 1.1, y yes u off podrían volverse booleanos en analizadores antiguos. Las cadenas que parecen números, fechas o booleanos necesitan comillas para seguir siendo cadenas, así que una conversión cuidadosa las conserva.
¿Puedo añadir comentarios al YAML después de convertir?
Sí, y es un motivo habitual para convertir. Escriba # seguido de su nota al final de una línea o en una línea propia. JSON no permitía explicar por qué se fija un valor; YAML sí, lo que facilita las revisiones y los traspasos.
¿Por qué mi YAML falla con un error de carácter de tabulación?
La especificación YAML prohíbe las tabulaciones en la sangría; solo cuentan los espacios. El convertidor escribe espacios, pero un editor configurado para insertar tabulaciones puede romper el archivo en la siguiente edición. Configure su editor para usar espacios en los archivos .yaml.
¿Kubernetes acepta el manifiesto convertido de JSON a YAML?
kubectl lee tanto JSON como YAML, así que los datos son los mismos en ambos casos; la versión YAML es simplemente la que usan la mayoría de la documentación, los charts de Helm y las revisiones de código. Si más adelante necesita volver a JSON para jq o una llamada a una API, YAML a JSON hace el camino inverso.
- Convertir YAML a JSONConvierta archivos .yaml y .yml en JSON para API, validadores y herramientas que solo leen JSON. Con sangría por defecto, lotes de 20, borrado a los 30 min.
- Convertir JSON a XMLConvierta JSON a XML en línea: claves como elementos y arrays como elementos repetidos, dentro de la etiqueta raíz que elija. Con sangría y sin cuenta.
- Convertir JSON a CSVConvierta JSON o JSON Lines a CSV: una fila por objeto, campos anidados en columnas y UTF-8 con BOM para que Excel muestre los acentos. 20 archivos a la vez.
- Convertir XML a JSONConvierta XML a JSON legible: atributos como claves @, etiquetas repetidas como arrays y texto intacto. Para respuestas SOAP, feeds y exportaciones.
- Convertir JSON a Base64Codifique un archivo JSON como una línea de Base64 para Secrets de Kubernetes, variables de CI, API y tokens. Reversible byte a byte, URI de datos opcional.
- Convertir JSON a ExcelConvierta JSON o JSON Lines en una hoja XLSX de Excel: las claves son los encabezados y cada registro una fila. Hasta 20 archivos por lote, sin cuenta.