YAML Error Encyclopedia
Direct answer
Most YAML failures are indentation, missing colons, or type-coercion surprises. Match your error message in this index, fix the structure, then re-validate with a YAML 1.2-aware parser.
How to use this index
Find the error message or symptom below, open the Q&A article, then validate the fixed file in the browser validator.
Parser errors
Language / tooling
Ecosystem configs
Basics
Fast triage checklist
- Convert tabs to spaces; keep one indent width (2 or 4).
- Ensure every mapping key ends with
:plus a space before a same-line value. - Quote colons inside plain strings, or use quoted scalars.
- Re-validate after each fix so line numbers stay meaningful.