This page is not available in every language. Missing translations are disabled in the language selector.

Quick reference

YAML Syntax Cheatsheet

A quick reference guide for YAML syntax: dictionaries, lists, multiline scalar strings, anchors, aliases, and merge keys.

· Published

YAML (YAML Ain't Markup Language) is a human-friendly data serialization standard for all programming languages.

Dictionaries & Lists

# Comments begin with "#"
# Dictionaries are written as "key: value"
name: Martin D'vloper
languages:
  perl: Elite
  python: Elite
  pascal: Basic

# List items begin with "- "
foods:
  - Apple
  - Orange
  - Strawberry
  - Mango

# Booleans use lowercase
employed: true

Multiline Strings

# Literal Block Scalar (preserves newlines)
multiline_literal: |
  exactly as you see
  will appear these three
  lines of poetry
# Folded Block Scalar (folds newlines to spaces)
multiline_folded: >
  this is really a
  single line of text
  despite appearances

Anchors & Inheritance

parent: &defaults
  a: 2
  b: 3

child:
  <<: *defaults
  b: 4

Reusable Sequences

values: &ref
  - These values
  - will be reused below

other_values:
  <<: *ref

Related topics