Validador de Archivos YAML Online: Formateador de Indentación y Espaciado con Errores en Español

Qué es y para quién

El validador de YAML analiza tu documento con el analizador js-yaml — el más usado en el ecosistema JavaScript — cargado en tu navegador. Si el documento es correcto, lo reescribe con una indentación consistente de 2 o 4 espacios y te dice qué tipo de estructura hay en la raíz (una tabla o una lista). Si no lo es, captura el error del analizador, calcula la línea aproximada y añade las pistas de los fallos más frecuentes.

Está pensada para quien toca ficheros YAML de Docker Compose, GitHub Actions, Kubernetes, Ansible, Home Assistant o cualquier aplicación que se configure en este formato.

Cómo se usa

Pega tu YAML, elige la indentación de salida y pulsa «Validar y formatear». Con un documento válido obtendrás la versión reordenada lista para copiar y guardar; ten en cuenta que formatear normaliza el estilo — las listas pegadas al margen pasan a la indentación elegida — pero no cambia los datos. Con un documento inválido, revisa primero la línea señalada: nueve de cada diez errores de YAML son de alineación o de caracteres especiales sin comillas.

Ejemplo resuelto

El ejemplo inicial trae un documento válido pero con estilos mezclados: una lista con guiones pegados al margen y un bloque indentado a 4 espacios. Al validar con salida de 2 espacios, la herramienta lo declara válido y lo devuelve así:

nombre: Ana
edad: 30
lista:
  - uno
  - dos
config:
  activo: true
  nivel: 3

Mismos datos, una sola regla de indentación. Y cambiando la salida a 4 espacios, la misma lista sale con cuatro: útil cuando el proyecto o el equipo ya trabaja con ese estilo y quieres que el archivo encaje sin retocarlo a mano.

Casos de uso

• Antes de desplegar: valida el docker-compose o el workflow antes de que falle en el servidor o en CI.
• Unificar estilo: reformatea archivos heredados con indentaciones mezcladas.
• Cazar el error: cuando una aplicación dice «error de YAML» sin más detalles, aquí obtienes la línea aproximada.
• Aprender YAML: prueba construcciones y comprueba al instante si son válidas.

Limitaciones y consejos

El formateo trabaja sobre los datos ya analizados: los comentarios del documento original no se conservan en la salida y el orden de las claves sí se mantiene tal cual estaba. La línea de error que muestra el analizador es aproximada — señala dónde se dio cuenta del problema, que a veces es una o dos líneas después del fallo real (una comilla o un corchete sin cerrar arrastran el error). YAML admite documentos múltiples separados por ---; esta herramienta valida el documento como una unidad, pensando en archivos de configuración normales. Si la librería no puede cargarse por conexión, la herramienta lo avisa con un mensaje en español en vez de fallar en silencio.

Preguntas frecuentes

¿Por qué YAML falla tanto por la indentación?

Porque en YAML la indentación es la estructura: no hay llaves ni etiquetas de cierre. Un espacio de más convierte un valor en hijo de la clave equivocada, y un tabulador — invisible — está directamente prohibido.

¿El formateo cambia mis datos?

No: claves, valores y su orden se conservan. Solo se normaliza la presentación (indentación y estilo de listas). Lo que sí se pierde son los comentarios, porque el analizador no los incluye en los datos.

¿Puedo validar YAML muy grande?

Sí, el análisis es local y rápido. Archivos de configuración normales se validan al instante; solo documentos de muchos megabytes podrían tardar unos segundos.

¿Qué hago si el error señala una línea que parece correcta?

Busca justo encima: una comilla sin cerrar, un [ sin ] o una clave mal alineada en las líneas anteriores suelen ser los culpables, porque el analizador «descubre» el problema al llegar a la línea siguiente.