acento.io
Herramienta dev

Convertidor JSON ↔ YAML

Convierte entre JSON y YAML de forma bidireccional, con tipos preservados y advertencias cuando se pierden comentarios — todo en tu navegador.

Por Carlos Suárez , Ingeniero de sistemas
Última actualización:

Qué hace este convertidor JSON ↔ YAML

Este convertidor JSON a YAML (y YAML a JSON) transforma estructuras de datos entre los dos formatos más usados en configuración de software, preservando tipos: los números siguen siendo números, los booleanos siguen siendo booleanos y los arrays mantienen su orden. La especificación de JSON está definida en la RFC 8259 del IETF — uno de más de 9.500 documentos que ese organismo mantiene activos. Esta versión en español incluye avisos explícitos cuando el YAML de entrada contiene comentarios o anclas, ya que JSON no tiene equivalente para ninguno de los dos. El resultado es honesto: nada desaparece en silencio. 100% en el navegador — tus datos nunca salen de tu equipo. Sin subidas, sin tracking, sin logs en servidor. Si además necesitas inspeccionar la estructura del JSON resultante con indentación y colores, el [formateador JSON](/es/json-formatter/) es el siguiente paso natural.

Características

  • Conversión bidireccional. Cambia de JSON → YAML o YAML → JSON con un solo clic en «Intercambiar». No tienes que recargar ni copiar a otra herramienta.
  • Tipos preservados. Números, booleanos, nulos y arrays se mapean correctamente. true en YAML se convierte en true en JSON, no en la cadena "true".
  • Aviso de comentarios perdidos. Cuando el YAML de entrada contiene comentarios (#), la herramienta muestra una advertencia visible. JSON no tiene sintaxis de comentarios, así que se descartan — pero nunca en silencio.
  • Anclas y alias expandidos. Las anclas YAML (&anchor) y los alias (*ref) se resuelven al convertir a JSON. El resultado es un objeto plano y válido, sin referencias internas.
  • Validación inmediata. Si el texto de entrada no es JSON o YAML válido, aparece el mensaje de error del parser en el acto, con la línea exacta del problema.
  • Vista lateral sincronizada. Entrada y salida se muestran en paralelo para comparar estructura antes de copiar. Útil al revisar manifiestos de Kubernetes o pipelines de CI.

Cómo usar el convertidor JSON ↔ YAML

Pega tu JSON o YAML, elige la dirección y copia el resultado. Sin instalación, sin cuenta.

  1. Pega el contenido. Copia tu JSON o YAML al panel izquierdo. Por ejemplo, un manifiesto de Kubernetes como apiVersion: apps/v1.
  2. Elige la dirección. Haz clic en «JSON → YAML» o «YAML → JSON» según lo que necesites. Usa «Intercambiar» para voltear la dirección sin perder el texto.
  3. Revisa las advertencias. Si tu YAML tiene comentarios o anclas, verás un aviso antes de copiar. Decide si eso es aceptable para tu caso de uso.
  4. Copia el resultado. Haz clic en «Copiar» para llevar el resultado al portapapeles. El botón confirma con «Copiado» durante un segundo.

Casos de uso comunes

  • Manifiestos de Kubernetes. Los equipos de plataforma en Ciudad de México o Barcelona escriben manifiestos en YAML para legibilidad, pero las APIs de Kubernetes aceptan JSON directamente. La conversión evita errores de indentación al pasar entre ambos.
  • Pipelines de CI/CD. Convertir configuraciones de GitHub Actions o GitLab CI a JSON permite inspeccionarlas con herramientas que solo entienden ese formato, como editores de esquemas o validadores de políticas.
  • Interoperabilidad entre sistemas. Cuando un sistema exporta JSON y otro espera YAML — o viceversa — este convertidor actúa como puente sin necesidad de scripts ad hoc. Si luego necesitas generar tipos TypeScript desde el JSON, el [conversor JSON a TypeScript](/es/json-to-typescript/) complementa este flujo.
  • Validación rápida de sintaxis. Pegar un fragmento sospechoso y ver si el parser lanza error es la forma más rápida de saber si tu YAML tiene tabs (prohibidos por la especificación) o comillas mal cerradas en JSON.

Preguntas frecuentes

¿Mis datos se envían a algún servidor?

No. La conversión ocurre completamente en tu navegador usando js-yaml compilado a JavaScript. Ningún byte de tu contenido sale de tu equipo — no hay logs, no hay backend, no hay análisis del contenido.

¿Por qué se pierden los comentarios al convertir YAML a JSON?

JSON no tiene sintaxis de comentarios — es una decisión de diseño de la especificación (RFC 8259). Cuando el parser lee el YAML, los comentarios existen solo como texto ignorado; al serializar a JSON no hay dónde mapearlos. La herramienta avisa de esto explícitamente para que no te lleves una sorpresa.

¿Qué pasa con `no`, `off` y `yes` en YAML?

En YAML 1.1 (la versión más extendida), no, off y yes se interpretan como booleanos. En YAML 1.2 son cadenas de texto. Si ves que un valor cambia de tipo inesperadamente, es probable que tu parser use la especificación 1.1. La herramienta sigue el comportamiento de js-yaml, que por defecto aplica YAML 1.2.

¿Las anclas y alias de YAML se conservan en la salida JSON?

No. Las anclas (&nombre) y los alias (*nombre) son una característica de YAML sin equivalente en JSON. Al convertir, se expanden: cada referencia se reemplaza por una copia completa del nodo al que apuntaba. El JSON resultante es válido y completo, pero más verboso.

¿Puedo usar esta herramienta con YAML muy largo, como un chart de Helm?

Sí. No hay límite de tamaño impuesto por la herramienta — el único tope es la memoria disponible en tu navegador. Para archivos de cientos de kilobytes el resultado puede tardar un segundo, pero todo se procesa localmente.

¿Por qué mi JSON válido falla al convertirlo a YAML?

El caso más común es JSON con claves duplicadas. La especificación permite claves repetidas pero los parsers estrictos las rechazan. Otro motivo frecuente: valores undefined o funciones JavaScript copiados desde la consola del navegador — esos no son JSON válido. El [formateador JSON](/es/json-formatter/) puede ayudarte a identificar el problema antes de convertir.