20 guides, cross-linked
Everything you need to actually understand YAML
Short, practical articles — no fluff, no filler — on YAML syntax, common mistakes, and where YAML shows up across Docker, Kubernetes, Ansible and CI pipelines.
What Is YAML? A Beginner's Guide
A plain-English introduction to YAML — what it stands for, what it looks like, and why so many dev tools quietly use it.
YAML vs JSON: Which One Should You Use?
A practical comparison of YAML and JSON — readability, comments, strictness, and when to reach for each.
YAML vs XML: A Simple Comparison
Why YAML replaced XML for a lot of configuration files, and where XML still holds on.
How to Write Comments in YAML
Everything you need to know about YAML comments: syntax, placement, and what doesn't work.
YAML Syntax Rules You Must Know
The core rules that govern every YAML file: indentation, colons, dashes, quoting, and document markers.
Common YAML Errors and How to Fix Them
The most frequent YAML parsing errors, what they actually mean, and the one-line fix for each.
YAML Anchors and Aliases Explained
How &anchor and *alias work in YAML, and why they're useful for keeping config files from repeating themselves.
How to Use YAML in Docker Compose
A walkthrough of a real docker-compose.yml file, explained section by section for people new to Docker.
YAML in Kubernetes: A Practical Guide
How to read a Kubernetes manifest file without getting lost, section by section.
YAML in GitHub Actions Workflows
Reading a .github/workflows file line by line — jobs, steps, triggers, and the parts people usually get wrong.
How to Validate YAML Online
How online YAML validation actually works, what it can and can't catch, and how to do it safely.
YAML Multiline Strings Explained
The difference between | and > block scalars in YAML, and when to use each.
YAML Data Types Explained
Strings, numbers, booleans, null, dates and lists — how YAML represents each one, and the traps to watch for.
YAML Indentation Rules (Spaces vs Tabs)
Why YAML forbids tabs, how many spaces to use, and how to actually see whitespace in your editor.
How to Convert YAML to JSON (and Back)
What actually happens during YAML-to-JSON conversion, and the handful of edge cases that can change your data.
YAML Front Matter in Markdown Files
How static site generators use a block of YAML at the top of a Markdown file, and how to write it correctly.
Best YAML Editors and Tools in 2026
What actually helps when editing YAML by hand — editor extensions, schema validation, and where an online formatter fits in.
YAML for Ansible Playbooks: A Beginner's Guide
How to read your first Ansible playbook — plays, tasks, and the YAML patterns that show up again and again.
YAML Security Risks You Should Know
Why unsafe YAML loading is a real vulnerability, and the simple habit that avoids it.
YAML Best Practices for Clean Config Files
A short checklist for writing YAML that's easy for your future self, and your teammates, to read.