Introduction to YAML

YAML is a lightweight, human-readable data format. It stores information in a structured way that both humans and computers can understand easily. YAML stands for YAML Ain't Markup Language. This is a recursive acronym, meaning the name refers back to itself. Earlier, YAML stood for Yet Another Markup Language, but the community changed the name to highlight that YAML focuses on data, not markup like HTML does.

YAML files use the .yml or .yaml file extension. Both extensions work the same way. Most developers prefer .yml for brevity.

What Problem Does YAML Solve?

Software applications often need settings and configurations. These settings tell an application how to behave — which port to use, what database to connect to, or which environment to run in. Before YAML, developers used formats like XML or INI files. These formats were either too complex or too limited.

YAML solved this by offering a format that:

• Looks clean and readable like a plain English list
• Supports complex structures like nested data
• Requires no special tags or brackets
• Works across all programming languages

A Simple Real-Life Analogy

Think of YAML like filling out a form. A job application form has fields like Name, Age, and Job Title. YAML works the same way — it lists a label on the left and its value on the right, separated by a colon.

name: John
age: 30
job: Developer

This is valid YAML. It is simple, clean, and easy to read. There are no brackets, no quotes required, and no confusing symbols.

Where Is YAML Used?

YAML appears in many popular tools and platforms used in modern software development and DevOps.

YAML vs Other Formats – A Quick Look

To understand why YAML is popular, compare the same data written in three different formats.

Same Data in XML

<person>
  <name>John</name>
  <age>30</age>
</person>

Same Data in JSON

{
  "name": "John",
  "age": 30
}

Same Data in YAML

name: John
age: 30

YAML is clearly the most readable. It removes curly braces, quotation marks, and angle brackets entirely.

Key Characteristics of YAML

• Indentation-based: YAML uses spaces (not tabs) to define structure. Indentation shows which data belongs inside which group.
• Case-sensitive: YAML treats Name and name as two different keys.
• Whitespace matters: Extra or missing spaces can break a YAML file.
• Supports multiple documents: One YAML file can contain multiple documents separated by ---.
• Supports comments: Lines starting with # are comments and are ignored by parsers.

A Simple YAML File Diagram

+-----------------------------+
|       person.yml            |
+-----------------------------+
|  name: Alice                |  ← Key: Value pair
|  age: 25                    |  ← Key: Value pair
|  city: New York             |  ← Key: Value pair
+-----------------------------+

Every line has a key on the left, a colon in the middle, and a value on the right. This is the foundation of all YAML files.

Is YAML a Programming Language?

No. YAML is not a programming language. It does not execute code. YAML only stores and organizes data. Applications read this data and use it to configure themselves. Think of YAML as a structured notepad where settings are written so that software can read them.

History of YAML

Clark Evans first proposed YAML in 2001. Ingy döt Net and Oren Ben-Kiki also contributed to its design. The YAML 1.2 specification was released in 2009 and remains the most widely used version. YAML was designed to be compatible with JSON, meaning all valid JSON is also valid YAML.

Summary

• YAML is a human-readable data format used for configuration files
• Files use the .yml or .yaml extension
• YAML is simpler than XML and JSON for humans to read
• Popular tools like Docker, Kubernetes, and GitHub Actions use YAML
• YAML is not a programming language — it only stores data