YAML¶

YAML 是 YAML Ain't a Markup Language （YAML 不是一种标记语言）的递归缩写。在开发的这种语言时，YAML 的意思其实是： Yet Another Markup Language （仍是一种标记语言）。

在 Kubernetes Atlas / Ansible 以及很多现代软件中大量使用了YAML，这种标记语言简单易懂，但是依然有一些小小的要点需要注意:

基本语法¶

大小写敏感
使用缩进表示层级关系
缩进不允许使用tab，只允许空格
缩进的空格数不重要，只要相同层级的元素左对齐即可
# 表示注释

数据类型¶

YAML 支持以下几种数据类型:

对象 : 键值对的集合，又称为映射（ mapping ）/ 哈希（ hashes ） / 字典（ dictionary ）
数组 : 一组按次序排列的值，又称为序列（ sequence ） / 列表（ list ）
纯量 ( scalars ): 单个的、不可再分的值

YAML 对象¶

对象键值对使用冒号结构表示 key: value ，冒号后面要加一个空格。

可以使用 key:{key1: value1, key2: value2, ...}

也可以使用锁进表示层级关系:

key:
    child-key: value
    child-key2: value2

YAML 数组¶

以 - 开头的行表示构成一个数组:

- A
- B
- C

支持多维数组:

可以使用行内表示:
```
key: [value1, value2, ...]
```
也可以使用子成员是一个数组，则可以在该项下面缩进一个空格:
```
-
 - A
 - B
 - C
```

复合结构¶

数组和对象可以构成复合结构:

languages:
  - Ruby
  - Perl
  - Python
websites:
  YAML: yaml.org
  Ruby: ruby-lang.org
  Python: python.org
  Perl: use.perl.org

转换为json:

{
  languages: [ 'Ruby', 'Perl', 'Python'],
  websites: {
    YAML: 'yaml.org',
    Ruby: 'ruby-lang.org',
    Python: 'python.org',
    Perl: 'use.perl.org'
  }
}

纯量¶

纯量是最基本的，不可再分的值:

字符串
布尔值
整数
浮点数
Null
时间
日期

案例:

boolean:
    - TRUE  #true,True都可以
    - FALSE  #false，False都可以
float:
    - 3.14
    - 6.8523015e+5  #可以使用科学计数法
int:
    - 123
    - 0b1010_0111_0100_1010_1110    #二进制表示
null:
    nodeName: 'node'
    parent: ~  #使用~表示null
string:
    - 哈哈
    - 'Hello world'  #可以使用双引号或者单引号包裹特殊字符
    - newline
      newline2    #字符串可以拆成多行，每一行会被转化成一个空格
date:
    - 2018-02-17    #日期必须使用ISO 8601格式，即yyyy-MM-dd
datetime:
    -  2018-02-17T15:02:31+08:00    #时间使用ISO 8601格式，时间和日期之间使用T连接，最后使用+代表时区

参考¶

YAML 入门教程