--- 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