What is YAML?
Short answer
YAML (YAML Ain't Markup Language) is a data serialization format designed to be easy for humans to read and write. It uses indentation instead of brackets and is common for configuration files like CI pipelines and Kubernetes manifests.
What YAML is for
YAML stores structured data — the same objects, arrays, strings, and numbers as JSON — but with a syntax tuned for humans. It is the default for many config files: GitHub Actions, Docker Compose, Kubernetes, and more.
How the syntax works
name: utilumo
version: 1
features:
- search
- dark mode
enabled: true- Indentation (spaces, never tabs) shows nesting
key: valuepairs map names to values- A leading
-marks each item in a list - Strings usually need no quotes; numbers and booleans are bare
#starts a comment — something JSON does not allow
YAML vs JSON
YAML is easier to read and supports comments, so it wins for hand-edited config. JSON is stricter and universal for APIs and data exchange. In fact, all JSON is valid YAML. See YAML vs JSON.