Skip to main content
Welcome to this lesson on YAML! In this tutorial, you’ll learn what YAML files are and how they are used to represent structured configuration data in a human-readable format. If you already have experience with YAML, feel free to skip ahead. However, if you’re just starting out, I highly recommend following along since a solid understanding of YAML is essential for the rest of this course. If you’ve worked with XML or JSON before, you’ll find that YAML is relatively straightforward. Below is an example YAML file that represents server configuration data:
Even if you haven’t worked with similar data formats, you’ll be able to pick up YAML quickly through our coding exercises. Next, let’s compare how the same data can be represented in XML, JSON, and YAML. The image below shows a sample list of servers with XML on the left, JSON in the middle, and YAML on the right:
The image shows a diagram of a server list represented in XML, JSON, and YAML formats.

​
Basic Key-Value Pairs

YAML primarily uses key-value pairs to represent data. Each key is followed by a colon and a space, and then its corresponding value. For example, consider the following simple YAML structure:

​
Representing Arrays

To represent arrays (or lists) in YAML, define a key with a colon. On the next line, list each item with a dash. Below is an example that combines both key-value pairs and arrays:

​
Grouping Properties with Dictionaries

Dictionaries (or maps) allow you to group related properties under a single key. For instance, to represent nutritional information, you might structure your YAML file with dictionaries and arrays as shown below:
Maintaining consistent indentation is crucial with YAML. Each level of nesting must be aligned with the same number of spaces. The image below illustrates the nutritional information of a banana using a dictionary/map format:
The image shows a diagram of a banana's nutritional information, including calories (105), fat (0.4g), and carbs (27g), labeled as a "Dictionary/Map."
Ensure you maintain consistent indentation. Extra spaces or incorrect indentation can lead to YAML syntax errors, such as accidentally nesting properties under the wrong key.

​
Lists of Dictionaries

YAML also supports lists that contain dictionaries. In the example below, each element in the list is a dictionary that represents the nutritional information of a fruit:

​
When to Use Dictionaries versus Lists

A common question is when to choose a dictionary over a list. YAML, much like XML and JSON, can describe various types of data—from organizational employee records to detailed information about vehicles. For example, consider a car object with properties such as color, model, transmission, and price. A dictionary is perfect to represent a single car:
The image illustrates a car's attributes using a dictionary format, showing color, model, price, and transmission type, with a car image in the center.
Here’s an example of a simple dictionary representing a car:
If you need to store multiple cars, you can use a list of dictionaries. This approach allows each car to have its own dictionary with full details:
This example highlights the difference between using a single dictionary for one car and a list of dictionaries for multiple cars.

​
Key Differences: Dictionaries vs. Lists

It’s important to understand the fundamental differences between dictionaries and lists:
  • Dictionaries:
    Dictionaries are unordered collections of key-value pairs. The order of keys does not matter; what is important is the integrity of the key-value mapping. For example, the following representations of a banana are equivalent:
  • Lists:
    Lists are ordered collections. The sequence in which items appear is significant. For example:
    Changing the order of items in the list will alter the sequence, which might be important depending on your use case.
Additionally, remember that any line beginning with a hash (#) is treated as a comment by the YAML parser and will be ignored:
With these concepts, you are now ready to dive into the coding exercises and start applying your YAML knowledge. Enjoy exploring YAML files, and happy coding! For further reading, consider checking out the following resources:

Watch Video

Practice Lab