# YAML Ain't Markup Language (YAML)

> A text format that is easy to read. It uses indents and is common for settings.

**Field:** Software Development  
**Category:** Files & Formats  
**Also known as:** YAML, YML, .yml file

## Think of it like

Think of it like a list with smaller lists in it. Indents show what goes under what.

## Definition

YAML is a text format built to be easy for people to read and write. It uses indents instead of brackets, and a dash starts each list item. It is the usual format for config files in tools like Docker Compose, Kubernetes and GitHub Actions. It also allows comments, which JSON does not. The spaces matter, so a wrong indent changes the meaning.

## Example

Jack writes a YAML file that tells his test server to run three steps. Each step is one line starting with a dash.

## Example code

```yaml
name: Emma
skills:
  - Python
  - Git
```

The indent and the dashes make skills a list of two.

## Why it matters

Most modern build and deploy tools are set up in YAML. Reading it is a daily skill.

## Common mistake

Using tabs to indent. YAML only accepts spaces, and a tab makes the file fail to load.

## Three principles

- **Indents, not brackets.** Spacing shows the shape.
- **Made for people.** Easy to read and edit.
- **Spaces only.** Tabs are not allowed.

## Related terms

- [JavaScript Object Notation (JSON)](https://learn.benibix.com/term/development/json)
- [Tom's Obvious Minimal Language (TOML)](https://learn.benibix.com/term/development/toml)
- [Configuration File](https://learn.benibix.com/term/development/config-file)
- [Extensible Markup Language (XML)](https://learn.benibix.com/term/development/xml)

## Told apart from

- [JSON vs YAML](https://learn.benibix.com/compare/json-vs-yaml): YAML uses indents and allows comments, so it suits settings files. JSON uses brackets and is the usual choice for APIs.

## Taught in

- [Config Files, YAML and TOML](https://learn.benibix.com/learn/development-formats/config-files-yaml-and-toml): File Formats, 5/11

---

Source: https://learn.benibix.com/term/development/yaml
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-18
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
