YAML 的定义是：“YAML Ain ’ t a Markup Language”，或者“Yet Another Markup Language”。
特点
- YAML 的数据组织主要依靠的是空白，缩进，分行等结构，可读性好。
- YAML 实现简单，解析成本很低，和脚本语言的交互性好。
- YAML 很容易就可以插入另一个 YAML 文件，甚至其他类型的文件，包括 XML, SDL, JSON 等。
- YAML 使用实现语言的数据类型。
- YAML 可以基于流来处理；
- YAML 表达能力强，扩展性好。
说明
基础
- 使用空白字符（不能使用Tab）分层，同层元素左侧对齐；
- 用“-”来表示一些序列的项（Sequence）；
- 用“：”来表示一对项目（Map）里的栏目（Key）和其相应的值（Value）；
- 单行注解由“#”字号开始，可以出现在行中任何位置；
- 字符串一般不使用引号，但必要的时候可以用引号框住；
- YAML也有用来描述好几行相同结构的数据的缩写语法，数组用“[]”包括起来，hash用“{}”来包括。
其它
- YAML使用可打印的Unicode字符，可使用UTF-8或UTF-16
- 使用双引号表示字串时，可用倒斜线（\）进行特殊字符转义
- 区块的字串用缩排和修饰词（非必要）来和其他资料分隔，有新行保留（使用符号<kbd>|</kbd>）或新行折叠（使用符号<kbd>></kbd>）两种方式
- 在单一档案中，可用连续三个连字号（---）区分多个档案
- 可选择性的连续三个点号（...）用来表示档案结尾(在流式传输时非常有用，不需要关闭流即可知道到达结尾处)
- 重复的内容可使从参考标记星号 （*）复制到锚点标记（&）
- 指定格式可以使用两个惊叹号 ( !! )，后面接上名称
- 允许在文件中加入选择性的空行，以增加可读性
- 在缩排中空白字符的数目并不是非常重要，只要相同阶层的元素左侧对齐就可以了
实例
简单实例
John.yaml
name: John Smith
age: 37
spouse:
name: Jane Smith
age: 25
children:
- name: Jimmy Smith
age: 15
- name: Jenny Smith
age: 12
John今年37岁，有一个幸福的四口之家。两个孩子Jimmy 和Jenny活泼可爱。妻子Jane年轻美貌。
也可缩写为：
name: John Smith
age: 37
spouse: {name: Jane Smith, age: 25}
children: [{name: Jimmy Smith, age: 15}, {name: Jenny Smith, age: 12}]
用 YAML 表达的一个购物发票
--- !clarkevans.com/^invoice
invoice: 34843
date : 2001-01-23
bill-to: &id001
given : Chris
family : Dumars
address:
lines: |
458 Walkman Dr.
Suite #292
city : Royal Oak
state : MI
postal : 48046
ship-to: *id001
product:
- sku : BL394D
quantity : 4
description : Basketball
price : 450.00
- sku : BL4438H
quantity : 1
description : Super Hoop
price : 2392.00
tax : 251.42
total: 4443.52
comments: >
Late afternoon is best.
Backup contact is Nancy
Billsmer @ 338-4338.
比较
JSON
JSON的语法是YAML1.2版的子集，同时非常接近YAML1.0与1.1版的子集，因此大部分的JSON文件都可以被YAML的剖析器剖析。这是因为JSON的语法结构和YAML的内置格式相同。虽然大范围的分层也可以使用类似JSON的内置格式，不过YAML标准并不建议这样使用，除非这样编写能让文件可读性增加。YAML的许多扩展在JSON是找不到的，如：进阶资料形态、关系锚点、字串不需要双引号、映射资料形态会储存键值的顺序。
