Herramientas
Blog Home

Formateador y Validador YAML Online Gratis

Formatea, valida y embellece YAML en tu navegador y convierte entre YAML y JSON. Funciona con configuraciones de Docker Compose, Kubernetes y GitHub Actions. Nada se envía nunca a un servidor.

Todo el análisis y la conversión ocurren localmente en tu navegador. Tu YAML y JSON nunca se suben, almacenan ni registran.

¿Qué es YAML?

YAML (YAML Ain't Markup Language) es un formato de serialización de datos legible por humanos, diseñado para ser fácil de escribir y leer. Su sintaxis limpia, basada en la sangría, ha sustituido a XML en muchos archivos de configuración modernos, impulsando herramientas como Docker Compose, Kubernetes, GitHub Actions, Ansible y Helm. YAML también es un superconjunto de JSON, por lo que todo documento JSON válido también es YAML válido, lo que hace que convertir entre ambos formatos sea sencillo y sin pérdidas para la mayoría de los datos de configuración cotidianos.

Guía de sintaxis YAML

key: value Escalares — un simple par clave/valor. Las cadenas multilínea usan | (literal, conserva los saltos de línea) o > (plegado, une las líneas).
- item Listas — cada elemento en su propia línea, precedido por un guion y un espacio.
parent: child: x Diccionarios anidados — expresan la jerarquía únicamente mediante la sangría.
# comment Comentarios — todo lo que sigue a un # es ignorado por el analizador.
null / true / false Valores especiales — null, true y false se reconocen como valores tipados, no como cadenas.
&anchor / *alias Anclas y alias — define un nodo una vez con &anchor y reutilízalo con *alias.
Importante: YAML no admite tabuladores para la sangría, solo espacios. Un único tabulador hace que todo el documento sea no válido.

YAML vs JSON: cuándo usar cada uno

YAML

Usa YAML para archivos de configuración escritos y editados a mano. Admite comentarios, es más legible y es el estándar de Docker Compose, Kubernetes, GitHub Actions, Ansible y Helm.

JSON

Usa JSON para las API y los datos en tránsito. Se analiza más rápido, no tiene ambigüedad de tipos y es el formato detrás de las API REST, package.json y tsconfig.json.

Errores YAML comunes y cómo corregirlos

  1. Usar tabuladores en lugar de espacios para la sangría — sustituye cada tabulador por espacios, ya que YAML prohíbe los tabuladores.
  2. Sangría inconsistente — mantén el mismo número de espacios en cada nivel de anidamiento en todo el documento.
  3. Una cadena que contiene dos puntos sin comillas — pon valores como "12:30" o "http://example.com" entre comillas.
  4. Booleanos ambiguos — valores como yes, no, on y off se interpretan como true/false; ponlos entre comillas si te refieres a las palabras literales.
  5. Caracteres especiales en un valor sin comillas — caracteres como @, # y { requieren que el valor esté entre comillas.

Preguntas Frecuentes

No. YAML prohíbe estrictamente los caracteres de tabulación para la sangría: debes usar espacios. Esta es una de las causas más comunes de los errores de "YAML no válido". Si tu editor inserta tabuladores, configúralo para convertirlos en espacios (normalmente 2 por nivel). El formateador de esta página siempre produce espacios, así que pasar tu archivo por él corrige los tabuladores accidentales automáticamente.

Ambos introducen cadenas multilínea pero gestionan los saltos de línea de forma distinta. El escalar de bloque literal | conserva los saltos de línea exactamente como se escriben, así cada línea se queda en su propia línea: ideal para scripts o texto formateado. El escalar de bloque plegado > une las líneas con espacios, reduciendo el bloque a una sola línea y tratando las líneas en blanco como saltos de párrafo: útil para texto largo que quieres ajustar en el origen pero almacenar en una sola línea.

Sí. Desde YAML 1.2, todo documento JSON válido también es un documento YAML válido, porque la sintaxis flow de YAML usa las mismas llaves, corchetes y reglas de comillas que JSON. Esto significa que puedes pegar JSON directamente en un analizador YAML y funcionará, y hace que la conversión entre ambos formatos sea fiable: exactamente lo que hacen las pestañas YAML a JSON y JSON a YAML de esta página.

Los analizadores YAML interpretan una serie de palabras — yes, no, on, off, true, false — como valores booleanos. Por eso el escalar sin comillas yes se lee como el booleano true y se serializa así en JSON. Si necesitas la cadena literal "yes" (por ejemplo un código de país o un campo de respuesta), ponla entre comillas: answer: "yes". Las comillas obligan al analizador a mantenerla como texto en lugar de convertirla en booleano.