Convertidor de JSON a YAML
Convierte arreglos u objetos JSON en YAML limpio y legible. Pega o sube JSON, elige el estilo de arreglo en bloque o en línea, la sangría y el entrecomillado, y copia o descarga el resultado, todo en tu navegador.
100% Procesamiento del Lado del Cliente
Tu JSON se analiza y convierte completamente en tu navegador. No se sube nada a un servidor.
Opciones
Índice
¿Qué es un convertidor de JSON a YAML?
Un convertidor de JSON a YAML toma datos JSON estructurados (un arreglo de objetos o un solo objeto) y los reescribe como YAML ("YAML Ain't Markup Language"), el formato de datos basado en sangría que se usa en manifiestos de Kubernetes, archivos de Docker Compose, pipelines de CI/CD (GitHub Actions, GitLab CI, CircleCI), playbooks de Ansible y muchísimos archivos de configuración de aplicaciones.
El convertidor recorre la estructura JSON y asigna cada clave a una entrada de mapeo YAML: las claves de objeto se convierten en líneas "clave: valor", los arreglos se convierten en ítems de lista con sangría (o listas en línea), y las cadenas se entrecomillan automáticamente solo cuando es necesario, produciendo YAML limpio y mínimo, fácil de leer y seguro de analizar.
Cómo funciona
- Añade tu JSON: pega el JSON directamente en el editor o sube un archivo .json.
- Elige tus opciones: define el tamaño de la sangría, si los arreglos deben mostrarse como listas en bloque o como listas en línea, y si los valores de cadena deben entrecomillarse solo cuando sea necesario o siempre.
- Lee el resultado al instante: la herramienta analiza tu JSON en el navegador y muestra el YAML convertido mientras escribes, junto con el conteo de líneas y caracteres.
- Copia o descarga: copia el YAML al portapapeles o descárgalo como archivo .yaml.
Características
- Pega JSON o sube un archivo .json
- Conversión instantánea mientras escribes, sin botones
- Funciona con un solo objeto JSON o con un arreglo de objetos
- Estilo de arreglo en bloque (- ítem por línea) o en línea ([a, b, c])
- Entrecomillado automático e inteligente: las cadenas solo se entrecomillan cuando es necesario (parecen números, son palabras reservadas o tienen caracteres especiales)
- Modo opcional "entrecomillar siempre" para una salida más estricta y explícita
- Sangría configurable (2, 4 u 8 espacios; YAML prohíbe las tabulaciones para sangrar, así que no hay opción de tabulación)
- Anida correctamente objetos dentro de arreglos y arreglos dentro de arreglos
- Los arreglos y objetos vacíos se muestran como [] y {} en lugar de omitirse
- Conteo de líneas y caracteres en vivo
- Procesamiento 100% en el navegador para tu privacidad
Buenas prácticas
- Deja el entrecomillado en "Automático" salvo que tengas un motivo para cambiarlo: el entrecomillado automático mantiene el resultado legible y a la vez entrecomilla con seguridad cualquier cosa ambigua, como una cadena que parece un número, un booleano o la palabra "null".
- Usa el estilo en línea para listas cortas de valores simples: una lista de etiquetas o IDs suele leerse mejor como una sola línea en línea que como varios ítems en bloque; el estilo en línea solo se aplica a arreglos de valores simples y vuelve automáticamente al estilo en bloque para arreglos que contienen objetos o arreglos anidados.
- Presta atención a las cadenas que parecen números pero deben seguir siendo texto: valores como códigos postales, extensiones telefónicas o IDs con un cero inicial (por ejemplo, "007") se entrecomillan automáticamente para que un analizador YAML no los reinterprete como números.
- Revisa dos veces las claves y valores que contienen dos puntos: un valor como "Winner: Best Programmer" se entrecomilla automáticamente, ya que una secuencia de dos puntos y espacio sin comillas se interpretaría como un mapeo anidado.
- Valida contra el dialecto YAML de tu herramienta de destino: la mayoría de las herramientas (Kubernetes, GitHub Actions, Docker Compose) aceptan el YAML estándar 1.1/1.2 que produce esta herramienta, pero siempre pasa el resultado por el validador o modo de prueba de tu sistema de destino antes de usarlo en producción.
Solución de problemas
Dice que mi JSON no es válido
Revisa si hay una coma sobrante después del último elemento de un arreglo u objeto, claves sin comillas, comillas simples en lugar de dobles, o un corchete sin cerrar: son las causas más comunes de que el JSON no se pueda analizar.
Un valor de cadena salió entrecomillado cuando no lo esperaba
Esto es intencional y seguro: las cadenas que parecen números, booleanos o las palabras null/true/false/yes/no (en cualquier combinación de mayúsculas) se entrecomillan automáticamente para que un analizador YAML las lea como cadenas, no como esos tipos.
Mi arreglo de objetos no se convirtió en una lista en línea
El estilo en línea ([a, b, c]) solo se aplica a arreglos formados enteramente por valores simples (cadenas, números, booleanos, null). Los arreglos que contienen objetos o arreglos anidados siempre usan el estilo en bloque (varias líneas), ya que los objetos en línea son mucho más difíciles de leer.
No hay opción de sangría con "tabulación"
La especificación de YAML no permite caracteres de tabulación literales para la sangría; solo los espacios son válidos. Por eso esta herramienta solo ofrece sangría de 2, 4 u 8 espacios, no tabulaciones.
Casos de uso comunes
- Escribir manifiestos de Kubernetes: convierte un objeto JSON que describe un Deployment, Service o ConfigMap al formato YAML que espera kubectl.
- Generar archivos de pipelines de CI/CD: convierte una configuración de pipeline definida en JSON al formato YAML que requieren GitHub Actions, GitLab CI o CircleCI.
- Migrar configuración de aplicaciones: convierte un archivo de configuración JSON a YAML para herramientas y frameworks (Docker Compose, Ansible, Spring Boot) que prefieren o requieren YAML.
- Documentar respuestas de API en un formato más legible: la ausencia de corchetes y comillas en la mayoría de los valores de YAML lo hace más fácil de leer en documentación que el JSON puro.
- Probar código que consume YAML: genera rápidamente payloads YAML de ejemplo a partir de fixtures de prueba en JSON sin escribir YAML a mano.
Preguntas frecuentes
Sí. Un solo objeto se convierte directamente en un mapeo YAML. Un arreglo de nivel superior se convierte en una secuencia en bloque de YAML, con cada ítem como una entrada de lista.
El estilo en bloque escribe un ítem del arreglo por línea con un guion inicial; es el estilo YAML estándar y más legible. El estilo en línea escribe el arreglo en una sola línea entre corchetes, como [a, b, c]; es más compacto, pero aquí solo se usa para arreglos de valores simples, nunca para arreglos de objetos.
Con el entrecomillado "Automático" (el predeterminado), una cadena solo se entrecomilla cuando dejarla sin comillas cambiaría su significado; por ejemplo, si parece un número ("007"), un booleano ("yes"), la palabra "null", o contiene dos puntos seguidos de un espacio. Las cadenas normales se dejan sin comillas por legibilidad.
Sí. Cambia "Entrecomillado de cadenas" a "Entrecomillar siempre" para envolver cada valor de cadena entre comillas dobles, lo necesite o no.
Los objetos anidados se convierten en mapeos YAML con sangría. Los arreglos anidados y los arreglos de objetos se sangran como secuencias en bloque, con la primera clave de cada objeto en la misma línea que su guion.
No. Todo ocurre localmente en tu navegador y nada se sube ni se guarda.
El convertidor funciona en la memoria de tu navegador, así que archivos JSON muy grandes (decenas de megabytes o más) pueden ir lentos o usar mucha memoria según tu dispositivo.