TOML on DocusNotes

TOML語法

Sat, 05 Sep 2026 00:00:00 +0000

TOML的全名是Tom’s Obvious, Minimal Language（湯姆的明顯、極簡語言）。它的設計目標是成為一個比JSON更易讀、比YAML更嚴謹的組態設定格式。不同於YAML依賴縮排，TOML主要是透過方括號 [] 來定義資料結構。

核心規則

三個特點：

使用等號 = 賦值
TOML的鍵值對一律使用等號（例如 title = "我的文章" ）。
對空格非常寬容
等號兩邊有沒有空格都沒關係（ title=1 和 title = 1 都對），而且縮排只為了美觀，不影響程式解析。
嚴格的型態與字串要求：字串必須用引號包起來，布林值必須是小寫的 true 或 false 。

四大基礎語法與資料型態

在Markdown的文章開頭（Front Matter），你會用到的TOML語法主要有以下四種：

基礎鍵值對（Key-Value）

tomltitle = "我的第一篇文章" # 字串：TOML的字串「一定要」加引號
draft = false # 布林值：必須小寫
weight = 10 # 整數
price = 99.9 # 浮點數

字串與引號（String）
TOML區分雙引號與單引號的方式：

雙引號 "" （基本字串）：支援跳脫字元（例如 \n 代表換行）。
```
tomldescription = "第一行\n第二行"
```
單引號 '' （字面字串）：不解析任何跳脫字元，裡面寫什麼就完全顯示什麼（適合用來寫網址或正則表達式）。
```
tomlimage_url = 'https://example.com'
```

陣列 / 列表（Array）
用來設定多個同類型的資料（如文章標籤）。

單行寫法（最常用）：

tomltags = ["網站架設", "Hugo", "教學"]

多行寫法（適合項目很多時）：