---
# System prepended metadata

title: YAML
tags: [模板]

---

---
title: YAML
tags: 模板
lang: zh-tw
---

# YAML

YAML 是"YAML Ain't a Markup Language"（YAML 不是一種標記語言）的遞歸縮寫。  
在開發的這種語言時，YAML 的意思其實是："Yet Another Markup Language"（仍是一種標記語言）。  
但為了強調這種語言以數據做為中心，而不是以標記語言為重點，而用反向縮略語重新命名。

:::danger
反正就是一個很有趣的縮寫。
:::

- YAML的配置文件後綴為`.yml`, `.yaml`
- YAML 的介紹
    - [YAML 入門教程| 菜鳥教程](https://www.runoob.com/w3cnote/yaml-intro.html)
    - [YAML - 維基百科，自由的百科全書](https://zh.wikipedia.org/wiki/YAML)
- HackMD 官方支援的 YAML 語法(中英文版本都附上)
    - [YAML metadata 說明](https://hackmd.io/s/yaml-metadata-tw)
    - [Supported YAML metadata](https://hackmd.io/s/yaml-metadata)

## 基本語法

- 大小寫敏感
- 使用縮進表示層級關係
- **縮進不允許使用tab，只允許空格!!**
- 縮進的空格數不重要，只要相同層級的元素左對齊即可
- '#'表示註釋

---

## 使用

要在最上面的地方，用兩個`---`包夾起來。

本來想把所有列法都列在下面，但是發現上面的連結參考很簡潔詳盡，所以沒有必要這樣做。  
建議還是去看上面連結即可。

- title: 設定筆記標題
- description: 設定筆記描述
- image: 設定筆記預設圖片 (用於連結預覽)。
- tags: 設定筆記標籤
- robots: 設定網路機器人 meta
    >我不會設定XD
- lang: 設定瀏覽器顯示語言
    > [ISO 639-1代碼表 - 維基百科，自由的百科全書](https://zh.wikipedia.org/wiki/ISO_639-1%E4%BB%A3%E7%A0%81%E8%A1%A8)
- dir: 設定文字方向
    > `rtl` or `ltr`
- breaks: 設定是否使用分行
- GA: 設定 Google Analytics
- disqus: 設定 Disqus
- slideOptions: 設定簡報模式的選項



| name | function| Column 3 |
| -------- | -------- | ------ |
| title   | Text   | Text   |
|          |          |        |
|          |          |        |
|          |          |        |

## 一些例子

```{yaml}
---
title: 書本模式-收合
description: 紀錄HackMD的一些模板設定
disqus: hackmd
tags: 模板
lang: zh-tw
image: https://s3-web-client.cos.twcc.ai/image/top-secret02.png
---
```

---

## END

