YAML Validator Online
Valida la sintaxis de tus archivos YAML. Detecta errores de indentación y formato al instante.
¿Qué es YAML y por qué necesitas validarlo?
YAML (YAML Ain't Markup Language) es un formato de serialización de datos diseñado para ser legible tanto por humanos como por máquinas. Se ha convertido en el estándar de facto para archivos de configuración en el ecosistema DevOps y cloud-native, siendo utilizado por Docker Compose, Kubernetes, Ansible, GitHub Actions, CI/CD pipelines y muchas otras herramientas modernas. Su sintaxis basada en indentación lo hace visualmente limpio, pero esa misma dependencia de la indentación es la fuente más común de errores.
A diferencia de JSON, que usa llaves y corchetes para definir la estructura, YAML utiliza la indentación (espacios, nunca tabs) para representar la jerarquía de datos. Un solo espacio extra o faltante puede cambiar completamente el significado del documento o causar errores de parseo difíciles de detectar. Por eso, un validador YAML es esencial para detectar problemas antes de desplegar configuraciones en producción.
Errores comunes en YAML
Uso de tabs: YAML no permite tabs para indentación. Solo se permiten espacios. Este es el error más frecuente y puede ser difícil de detectar visualmente en algunos editores.
Indentación inconsistente: Mezclar diferentes niveles de indentación (por ejemplo, 2 espacios en un nivel y 4 en otro) puede causar errores de parseo o interpretaciones incorrectas de la estructura.
Dos puntos sin espacio: Después de los dos puntos en un par clave-valor, debe haber al menos un espacio. key:value es inválido, mientras que key: value es correcto.
YAML vs JSON
YAML es un superconjunto de JSON, lo que significa que cualquier documento JSON válido también es YAML válido. Sin embargo, YAML ofrece características adicionales como comentarios (con #), anchors y aliases para reutilizar valores, documentos múltiples separados por ---, y tipos de datos más ricos como fechas y timestamps nativos. Mientras JSON es preferido para APIs por su simplicidad y velocidad de parseo, YAML domina en configuración por su legibilidad superior.
Preguntas frecuentes
¿Por qué YAML no permite tabs?
YAML prohíbe los tabs porque diferentes editores y sistemas los interpretan de manera distinta (algunos como 2 espacios, otros como 4 u 8). Esto causaría inconsistencias en la interpretación de la indentación. Usar espacios garantiza que el documento se vea y parsee igual en cualquier entorno.
¿Cómo represento strings multilínea en YAML?
YAML ofrece dos operadores: el pipe | preserva los saltos de línea (literal block), y el mayor-que > los convierte en espacios (folded block). Ambos son útiles para incluir texto largo, scripts o configuraciones embebidas dentro de un archivo YAML.
¿YAML soporta comentarios?
Sí, YAML soporta comentarios usando el símbolo #. Todo lo que sigue al # en una línea se ignora durante el parseo. Los comentarios pueden ir en su propia línea o al final de una línea de código. Esta es una ventaja significativa sobre JSON, que no permite comentarios.
¿Cuál es la extensión correcta para archivos YAML?
Las extensiones oficiales son .yaml y .yml. La especificación YAML recomienda .yaml cuando sea posible, pero .yml es igualmente válido y muy común, especialmente en entornos donde las extensiones de tres caracteres eran la norma (como Windows antiguo).