About

Formateador y validador de YAML

Pega YAML, formatea con sangría de 2 espacios o valida la sintaxis. Modo estricto YAML 1.2. Sin subida.

  1. Pega tu YAML en el área de texto izquierda.
  2. Haz clic en Formatear para hacer round-trip por el parser y emitir YAML canónico.
  3. Haz clic en Validar para comprobar la sintaxis sin modificar la entrada.
  4. Los errores apuntan a la línea y columna ofensoras.
¿Qué hace?

Parsea tu YAML con js-yaml en modo estricto YAML 1.2 y lo re-emite con sangría de 2 espacios, ancho de línea de 100 columnas y entrecomillado consistente. El botón Validar comprueba la sintaxis y reporta el primer error sin cambiar la entrada. La salida es semánticamente equivalente a la entrada — valores, tipos y estructura se preservan.

Ejemplo

Entrada YAML desordenada:

name:    Ada
tags: [math,logic]
active:true

Salida formateada:

name: Ada
tags:
  - math
  - logic
active: true

Errores comunes de YAML y cómo arreglarlos

YAML 1.2 en modo estricto es implacable con los espacios. Los patrones a continuación cubren la mayoría de fallos del parser.

  • Tabuladores en lugar de espacios. YAML 1.2 prohíbe tabuladores para indentación. Reemplaza cada tab con espacios.
  • Niveles de indentación inconsistentes. Un hijo indentado con 2 espacios bajo un hermano de 4 espacios fallará. Elige un ancho y úsalo consistentemente.
  • Trampas booleanas. En YAML 1.1 (no este modo), `yes`, `no`, `on`, `off` se parseaban como booleanos. js-yaml usa 1.2, pero entradas reales que dependen del comportamiento antiguo sorprenden a los usuarios. Comilla los valores ambiguos: `country: "NO"`.
  • Caracteres especiales sin comillas. Los valores que empiezan con `:`, `?`, `&`, `*`, `!`, `|`, `>`, `\'`, `"`, `%`, `@`, `` ` `` necesitan comillas.
  • Comilla sin cerrar. Una comilla de cierre faltante hace que el parser absorba el resto del archivo como parte de la cadena. La línea reportada puede estar lejos del error real.
  • Discordancia anchor / alias. Un alias `*name` que referencia un anchor no declarado `&name` lanza un error. Verifica que cada alias tenga un anchor coincidente declarado antes.
Preguntas frecuentes

¿Formatear cambia mis datos?

No — solo el espacio en blanco, las comillas y el orden de los detalles representacionales. El grafo de valores parseados es idéntico. El YAML formateado se re-parsea a la misma estructura en memoria que el original.

¿Se preservan los comentarios al formatear?

No. js-yaml no retiene comentarios a través de un round-trip parse-and-dump. Si necesitas formateo YAML que preserve comentarios, usa una biblioteca diferente (yaml.js con opciones, o una herramienta CLI como `prettier --parser yaml`).

¿Puedo personalizar la indentación?

La compilación actual usa sangría de 2 espacios. Para personalizar, ejecuta js-yaml en línea de comandos — misma biblioteca — y pasa `{ indent: 4 }` o lo que necesites.

¿Qué tan grande puede ser el archivo YAML?

Hasta unos 10 MB antes de que el textarea se ralentice. La mayoría de archivos de configuración están bien por debajo de 1 MB.

¿Mi YAML se sube?

No. Todo se ejecuta en tu navegador — tu entrada se parsea y re-serializa por JavaScript en esta página y nunca se envía a un servidor.

¿Esto lintea problemas de estilo como claves duplicadas?

js-yaml en configuración por defecto rechazará claves duplicadas (un requisito estricto de YAML 1.2). Otros problemas de estilo como entrecomillado inconsistente o nombrado de anchors no se marcan — eso necesita un linter dedicado como yamllint.