UlvixorValidador de YAML
Pega un documento YAML y valida su sintaxis al instante con js-yaml, la misma librería que usan muchas herramientas de desarrollo. Si es válido, verás la estructura interpretada como JSON para confirmar que se leyó como esperabas.
Cómo funciona
- Pega o escribe tu YAML en el panel de entrada.
- El validador intenta interpretar (parsear) el documento con js-yaml.
- Si es válido, se muestra la estructura resultante como JSON legible, para que confirmes que los tipos y la jerarquía son los que esperabas.
- Si hay un error, se muestra el mensaje de js-yaml, incluyendo línea y columna cuando están disponibles.
- Copia el JSON resultante o descárgalo como archivo .json.
Casos de uso
- Validar archivos de configuración de CI/CD (GitHub Actions, GitLab CI, Docker Compose) antes de hacer commit.
- Depurar errores de indentación, que son la causa más común de YAML inválido.
- Confirmar cómo se interpretan los tipos de datos (números, booleanos, null) en un archivo YAML.
- Convertir mentalmente YAML a su equivalente en JSON para entender su estructura.
Casos de uso
- Validar archivos de configuración de CI/CD (GitHub Actions, GitLab CI, Docker Compose) antes de hacer commit.
- Depurar errores de indentación, que son la causa más común de YAML inválido.
- Confirmar cómo se interpretan los tipos de datos (números, booleanos, null) en un archivo YAML.
- Convertir mentalmente YAML a su equivalente en JSON para entender su estructura.
Errores comunes
- Mezclar espacios y tabulaciones para la indentación.YAML solo permite espacios. Un tabulador causa un error de sintaxis que a veces es difícil de ver a simple vista; el validador te muestra la línea exacta.
- Escribir valores como yes, no, on, off esperando que se interpreten como texto.En YAML estos valores suelen interpretarse como booleanos. Si necesitas el texto literal, enciérralo entre comillas: "yes".
- Usar indentación inconsistente entre elementos del mismo nivel.Todos los elementos de un mismo nivel deben tener exactamente la misma cantidad de espacios de indentación.
Preguntas frecuentes
No. Todo el análisis ocurre localmente en tu navegador usando la librería js-yaml. Tu YAML nunca sale de tu equipo.
YAML usa la indentación (espacios, nunca tabulaciones) para representar la jerarquía de los datos, en lugar de llaves o corchetes como JSON. Un espacio de más o de menos puede cambiar por completo la estructura interpretada o causar un error de sintaxis, que es justamente el tipo de problema que esta herramienta detecta.
Se muestra el mensaje de error exacto que reporta js-yaml, que normalmente incluye la línea y columna donde se detectó el problema, además de una descripción de qué se esperaba encontrar.
Mostrar la estructura como JSON permite confirmar sin ambigüedad cómo se interpretó cada valor (por ejemplo, si 'yes' se leyó como texto o como booleano), algo que es más difícil de verificar solo con YAML reformateado.
Alternativas
Herramientas de línea de comandos como yamllint son útiles para validar archivos completos dentro de un pipeline de CI. Esta herramienta es más rápida para revisar un fragmento puntual y ver de inmediato cómo se interpreta como JSON.