What Is YAML? Explained Simply

What YAML is

YAML is a data format designed to be easy for humans to read and write. It is used mainly for configuration files, the settings that tell software how to behave. Where some formats are cluttered with brackets and punctuation, YAML uses a clean, indentation-based layout that reads almost like an outline. This human-friendly design has made YAML extremely popular in modern software, especially for configuring the tools and systems that developers and operations teams work with every day.

How its structure works

YAML represents data as key-value pairs, lists, and nested structures, using indentation to show how things relate. Instead of wrapping sections in brackets, you indent them underneath their parent, much like a bulleted outline. A setting might have a name and a value on the same line, and related settings are grouped by indenting them together. This layout makes the structure of the data visually obvious, which is a big part of YAML's appeal.

Why developers like it

YAML's main attraction is readability. Configuration files are meant to be read and edited by people, and YAML's clean, uncluttered format makes that pleasant. It avoids much of the punctuation that can make other formats hard to scan, and it supports comments, so you can explain settings right in the file. For configuration, where clarity matters more than raw efficiency, YAML's human-friendly style is often preferred over more verbose or symbol-heavy alternatives.

YAML vs. JSON

YAML and JSON are closely related, in fact, YAML is a superset of JSON, so any JSON is also valid YAML. The difference is style: JSON uses brackets and quotes and is great for data exchange between programs, while YAML uses indentation and is optimized for human readability, making it popular for configuration. Many tools accept both. The choice often comes down to purpose: JSON for data transfer, YAML for files people will read and edit.

Watch the whitespace

Because YAML uses indentation to define structure, whitespace is significant, getting it wrong can change the meaning or cause errors. A misplaced space or using tabs instead of spaces can break a YAML file. This is the flip side of YAML's clean look: the layout is not just cosmetic, it is part of the data. Editors that highlight indentation help, and it is a common gotcha worth knowing about when you first start working with YAML.

Why it matters

YAML has become one of the most common configuration formats in modern software, especially in areas like automation, deployment, and cloud tooling. Understanding it clarifies the files you will encounter configuring all sorts of systems, and knowing that indentation matters saves you from a frequent source of frustration. For anyone working with modern development or operations tools, YAML is a format well worth understanding.

Related on Skillo

See also: What is JSON? Explained simply, What is XML? Explained simply.

Sources

• YAML - Wikipedia

Published date reflects the original event date (2024-10-01). This article is original Skillo editorial written from the sources above; facts were verified in September 2026.