Convertidor de JSON ↔ YAML
Convierte JSON a YAML y YAML de vuelta a JSON directamente en tu navegador. Pega cualquiera de los dos formatos para obtener una salida limpia y correctamente indentada, ideal para archivos de configuración, pipelines de CI y manifiestos de Kubernetes.
Indentación
Introduce datos arriba para ver aquí el resultado convertido.
Cómo usar Convertidor de JSON a YAML
- 1
Elige una dirección
Usa el conmutador para elegir entre JSON a YAML o YAML a JSON. El botón de intercambio lleva tu resultado al campo de entrada para que puedas convertirlo de nuevo en sentido contrario.
- 2
Pega tus datos
Pega JSON o YAML en el campo de entrada. La conversión se ejecuta automáticamente a medida que escribes, conservando la estructura, el anidamiento y los tipos de datos.
- 3
Elige la indentación
Elige una indentación de 2 o 4 espacios para que coincida con el estilo de tu proyecto. La salida se mantiene limpia y correctamente indentada en cualquiera de los dos formatos.
- 4
Copia el resultado
Revisa la salida convertida y cópiala al portapapeles, lista para pegarla en un archivo de configuración, un pipeline o tu código.
De JSON a YAML: configuración más limpia sin los tropiezos
YAML es un superconjunto de JSON
Todo documento JSON válido es también YAML válido: eso es una garantía de la especificación de YAML, no una coincidencia. YAML añade una capa más amigable para los humanos por encima: en lugar de llaves y corchetes, la estructura se expresa mediante la sangría; en lugar de comas, los elementos van en sus propias líneas; y, a diferencia de JSON, YAML admite comentarios. El resultado se lee como un esquema en lugar de como un volcado de datos, que es por lo que domina los archivos de configuración.
Como los modelos de datos coinciden tan de cerca —ambos tienen mapas, secuencias, cadenas, números, booleanos y null— convertir entre ellos es mecánico y sin pérdidas para los valores en sí. La conversión vuelve a expresar el mismo árbol en una sintaxis de superficie distinta. Lo único que no puede sobrevivir a un viaje de ida y vuelta a JSON son los comentarios, ya que JSON no tiene dónde ponerlos.
La sangría es la sintaxis
En YAML, el espacio en blanco no es cosmético: es la estructura. El anidamiento se muestra sangrando las claves hijas más que su padre, y los elementos a la misma profundidad deben compartir la misma sangría. Un mapa anidado bajo una clave pasa a ser un conjunto de líneas sangradas debajo de ella; una lista pasa a ser líneas que empiezan cada una con un guion. Equivócate con la sangría y cambias el significado, no solo la apariencia, que es lo opuesto a cómo trata JSON el espacio en blanco.
Elige un ancho de sangría coherente —dos espacios es el valor predeterminado común para los archivos de configuración, cuatro para algunos estilos de casa— y aplícalo en todas partes. El conversor emite una sangría limpia y uniforme para que partas de una base correcta en lugar de alinear las líneas a mano.
Las tabulaciones están prohibidas
Esta es la regla que pilla a casi todo el mundo la primera vez. La especificación de YAML prohíbe explícitamente los caracteres de tabulación para la sangría; debes usar espacios. Un editor configurado para insertar una tabulación cuando pulsas la tecla Tab producirá en silencio un archivo que falla al analizarse, a menudo con un mensaje de error que apunta al lugar equivocado, porque el analizador solo nota que la estructura está rota una o dos líneas más tarde.
Si un archivo YAML se niega a cargarse y la sangría parece correcta, comprueba primero si hay tabulaciones. Configura tu editor para mostrar el espacio en blanco o para convertir las tabulaciones en espacios en los archivos YAML. Convertir desde JSON esquiva esto por completo, ya que la salida generada está sangrada con espacios desde el principio.
El problema de Noruega y otros booleanos sorpresa
Los analizadores YAML más antiguos interpretan una gama asombrosa de palabras sueltas como booleanos: no solo true y false, sino yes, no, on y off con distintas combinaciones de mayúsculas y minúsculas. El desastre clásico es una lista de códigos de país donde la entrada de Noruega, escrita como las letras sueltas n y o, se lee como el booleano false y desaparece en silencio de tus datos. Los indicadores de alternancia escritos como on u off pueden cambiar de tipo de la misma manera.
La defensa es el entrecomillado. Cualquier cadena que pudiera confundirse con un booleano, un número, una fecha o null debería envolverse en comillas para que el analizador la mantenga como texto. Los analizadores modernos construidos en torno al esquema seguro son más estrictos y mucho menos propensos a esto, pero merece la pena conservar el hábito de entrecomillar los escalares ambiguos, especialmente para los códigos cortos, las cadenas con aspecto de versión y cualquier cosa proporcionada por el usuario.
Más tropiezos con los escalares: números, ceros a la izquierda y null
Algunos otros valores sueltos sorprenden a la gente. Un código postal o un número de pieza con un cero a la izquierda puede leerse como un número y perder el cero, o interpretarse como octal en algunos analizadores. Las cadenas de versión como 1.20 pueden coaccionarse al número 1.2, perdiendo el cero final. La palabra null, un valor vacío y una virgulilla solitaria significan todos null. Igual que con la trampa de los booleanos, la cura es la misma: entrecomilla cualquier cosa cuya forma textual importe.
Como esta herramienta analiza con el esquema seguro, carga solo tipos de datos estándar y nunca construye objetos arbitrarios ni ejecuta código, así que pegar YAML no confiable no puede ejecutar nada. Eso mantiene la conversión predecible: lo que recuperas son mapas, secuencias y escalares simples, sin tipos personalizados sorpresa colados a través de etiquetas.
Dónde vive de verdad YAML
La legibilidad de YAML lo convirtió en la lengua franca de la infraestructura y las herramientas de CI. Los archivos de Docker Compose, los manifiestos de Kubernetes, los pipelines de GitHub Actions y GitLab CI, los playbooks de Ansible e innumerables archivos de configuración de aplicaciones son todos YAML. En cada uno de ellos, los comentarios y los diffs limpios que YAML permite son una ventaja real cuando un humano tiene que revisar un cambio en la configuración de producción.
JSON, por el contrario, sigue siendo la mejor opción para el intercambio entre máquinas a través de las API, donde su rigor y la ausencia de sensibilidad al espacio en blanco reducen la ambigüedad. Un patrón común es redactar y editar en YAML por comodidad humana y luego convertir a JSON cuando una herramienta o un endpoint lo exige, que es justo por lo que este conversor funciona en ambas direcciones.
Estilo de bloque, estilo de flujo y leer la salida
YAML puede expresar los mismos datos de dos maneras. El estilo de bloque despliega los mapas y las listas a lo largo de líneas sangradas y es lo que quieres para una configuración legible. El estilo de flujo usa llaves y corchetes en línea y se parece casi exactamente a JSON, lo que resulta ocasionalmente práctico para valores cortos y compactos incrustados en un documento más grande. Conocer ambos te ayuda a leer sin confusión el YAML escrito por otras personas.
Cuando conviertas aquí, pega el JSON, elige tu ancho de sangría y revisa la salida en estilo de bloque antes de colocarla en un repositorio. Todo ocurre localmente en tu navegador, así que los secretos de un archivo de configuración —tokens, cadenas de conexión, nombres de host internos— nunca salen de tu dispositivo, lo que hace seguro convertir manifiestos de despliegue reales en lugar de ejemplos saneados.
Preguntas frecuentes
¿Cuál es la diferencia entre JSON y YAML?
¿Cómo convierto JSON a YAML?
¿Puede convertir YAML de nuevo a JSON?
¿Es seguro analizar aquí YAML no confiable?
¿Se suben mis datos a un servidor?
Herramientas relacionadas
Sigue trabajando con estas prácticas herramientas