YAML
YAML (YAML Ain't Markup Language) is a human-friendly data serialization format that uses indentation and minimal punctuation to represent structured data, commonly used for configuration files and infrastructure definitions.
Definition
YAML (YAML Ain't Markup Language) is a human-friendly data serialization format that uses indentation and minimal punctuation to represent structured data, commonly used for configuration files and infrastructure definitions.
Overview
YAML was designed specifically to be easy for humans to read and write, in contrast to JSON's machine-friendly but punctuation-heavy syntax and XML's verbose tags. Instead of braces and brackets, YAML relies on indentation to express nested structure, along with a plain, low-noise syntax for lists and key-value pairs, and it supports comments, which JSON notably lacks — a small but significant convenience for configuration files that people edit by hand. Because every valid JSON document is also valid YAML, tooling can often treat the two formats interchangeably, and it's common to see APIs or libraries that accept either. YAML's real strength shows up in the DevOps and infrastructure world: Kubernetes manifests, Docker Compose files, GitHub Actions workflows, Ansible playbooks, and countless CI/CD pipeline definitions are all written in YAML, since its readability matters far more than parsing speed for files that engineers write and review by hand. YAML's indentation-sensitive syntax is also its most common source of bugs — a misplaced space can silently produce a different document structure rather than a parse error — which is why editors and linters that flag indentation issues are considered essential when working with large YAML files, and why some teams generate YAML programmatically from higher-level tools like Terraform rather than hand-writing it for complex infrastructure.
Key Features
- Indentation-based structure instead of braces or tags
- Supports comments, unlike standard JSON
- Superset of JSON — any valid JSON is valid YAML
- Compact syntax for lists, maps, and nested structures
- Widely used for CI/CD, container, and infrastructure configuration
- Sensitive to indentation errors, a common source of subtle bugs