Cómo usar: Validador YAML
- Pega el YAML o abre un archivo
.yml/.yaml. - Los errores muestran la línea, la columna y un indicador con el punto exacto.
- Revisa las advertencias del linter sobre tabuladores, espacios al final y trampas de YAML 1.1.
- Copia el YAML formateado o el equivalente en JSON.
Por qué YAML se rompe tan fácilmente
YAML usa la sangría para definir la estructura, así que un solo espacio mal colocado cambia el significado o hace que el archivo no sea válido. Los errores más comunes:
| Error | Causa |
|---|---|
| bad indentation of a mapping entry | Una clave tiene una sangría distinta a la de sus hermanas |
| found a tab character | YAML prohíbe los tabuladores para la sangría; usa espacios |
| duplicated mapping key | La misma clave aparece dos veces en un mismo objeto; la mayoría de parsers conserva la última sin avisar |
| incomplete explicit mapping pair / unexpected end | Una comilla o corchete sin cerrar, o dos puntos dentro de una cadena sin comillas |
| end of the stream or a document separator is expected | Contenido con una sangría incorrecta después de una lista o un bloque |
Trampas de YAML 1.1 frente a 1.2
Muchas herramientas (PyYAML, bibliotecas antiguas de Ruby y Go) siguen YAML 1.1, donde yes, no, on y off son booleanos y 012 es octal. Es el famoso «problema de Noruega»: el código de país NO se convierte en false. YAML 1.2 trata estos valores como cadenas. El linter marca estos valores para que los entrecomillES y obtengas el mismo resultado en todas partes.
Archivos multidocumento
Los manifiestos de Kubernetes suelen combinar varios recursos separados por ---. Cada documento se valida y se muestra en la salida JSON como un array.
Validar el significado, no solo la sintaxis
Un YAML válido puede seguir siendo una configuración incorrecta. Para comprobar la estructura frente a un esquema, conviértelo a JSON y usa el validador de JSON Schema; para especificaciones de API, el validador de OpenAPI. Crea archivos nuevos con el generador de Docker Compose o el generador de GitHub Actions, y convierte formatos con YAML a JSON.
También se busca como: linter yaml, comprobar yaml, validar yaml online, errores de sintaxis yaml, formatear yaml, validador yaml kubernetes, yamllint online.
Herramientas que combinan con: Validador YAML
- JSON a YAML — Pega tu JSON y obtén YAML limpio para manifiestos de Kubernetes, Docker Compose, GitHub Actions o cualquier archivo de configuración.
- Generador de YAML de Kubernetes — Indica el nombre de tu app, la imagen y el puerto, y obtén YAML de Kubernetes listo para producción: un Deployment con probes, límites de recursos y un contexto de seguridad reforzado, además del Service, el Ingress con TLS, el ConfigMap, el Secret y el HorizontalPodAutoscaler que marques, todo en un solo archivo listo para kubectl apply.
- Generador de servicios systemd — Ejecuta tu app como un servicio de Linux que arranca con el sistema y se reinicia si falla.
- Generador GitLab CI — Elige tu stack y obtén un .gitlab-ci.yml funcional: instalación con caché, jobs de lint y test, un build con artefactos, una imagen Docker subida al registry de GitLab o un deploy a GitLab Pages, con reglas que ejecutan los pipelines para merge requests y tu rama principal sin duplicados.