Formateador y validador de YAML

Qué hace

YAML es popular en archivos de configuración —manifiestos de Kubernetes, flujos de GitHub Actions y GitLab CI, Docker Compose, playbooks de Ansible, documentos OpenAPI— porque es fácil de leer. También es fácil de romper: una sangría equivocada, un tabulador, una comilla sin cerrar o un espacio que falta tras los dos puntos pueden cambiar el significado de un archivo o impedir que se cargue.

Este validador analiza tu YAML e informa de cada error de sintaxis con su línea y columna, además de avisos como directivas desconocidas. Cuando el YAML es válido, muestra el número de documentos y el tipo de cada valor raíz, y puede mostrar una copia reformateada con sangría uniforme.

Cómo se usa

1. Pega YAML en la entrada, sube un archivo .yaml o .yml, o pulsa Ejemplo.
2. El resultado aparece mientras escribes: una insignia verde YAML válido o una lista de errores como Línea 3, columna 2.
3. Deja activado Mostrar YAML formateado para obtener una copia ordenada y elige 2 o 4 espacios de sangría. Cópiala con el botón situado encima del bloque.
4. Desactiva Claves duplicadas como error solo si tus herramientas permiten claves repetidas.

Errores frecuentes

server:
  port: 8080
   host: localhost   # indented one space too far
tags: [web, api      # missing closing bracket

• Sangría inconsistente: los elementos del mismo nivel deben empezar en la misma columna. YAML no admite tabuladores para sangrar.
• Falta un espacio tras los dos puntos: key:value es una cadena simple, no una clave y un valor.
• Caracteres especiales sin comillas: los valores que empiezan por *, &, !, %, @ o una comilla invertida, o que contienen : o #, necesitan comillas.
• Tipos inesperados: yes, no, on y off son cadenas en YAML 1.2 pero booleanos en parsers antiguos de YAML 1.1; ponlos entre comillas por si acaso. Números de versión como 1.10 se convierten en el número 1.1 si no van entre comillas.

Validar la estructura

Esta herramienta comprueba la sintaxis: si el texto es YAML bien formado. Para comprobar que un archivo tiene las claves y los tipos correctos, conviértelo con la herramienta YAML a JSON y valida el resultado con el Validador de JSON Schema.