文件 1.11.6

標題、分隔線與引用

本頁說明標題、水平分隔線、引用區塊與 GitHub 樣式提示框的寫法。

標題

寫法 輸出
# 文字 ~ ###### 文字 <h1> ~ <h6>
文字 下一行 ===(3 個以上) <h1>
文字 下一行 ---(3 個以上) <h2>
表格儲存格內 | ## 文字 | 儲存格內的 <h2>
規則 說明
# 後需有空白 #tag 不是標題,可能成為 Hashtag 連結
允許前導 行首空白、> 、列表記號(- 、1. )之後的 # 也會成為標題
跳脫 \# 文字 不轉換
不產生 id 標題沒有 id 屬性,無法以錨點連結

水平分隔線

獨立一行的 --- 或 ***(3 個以上,前後可有空白)輸出 <hr>。

寫法 結果
---、***** <hr>
* * *、- - - 不支援;會被解讀為列表
___ 不支援
文字下一行的 --- setext <h2>,不是分隔線

引用

> 第一層
>> 第二層
> - 引用內的列表
規則 說明
起始 每一行以 > 開頭,連續的行合併為同一個 <blockquote>
巢狀 >> 產生內層 <blockquote>;之後同一區塊內的 > 行會接在內層,不會回到外層
內容 每一行包成 <span>;先經過列表轉換,可放列表

提示框

擴充模式支援 GitHub 樣式的提示框,標記必須是引用的第一行:

> [!WARNING]
> 這個動作無法復原
標記 圖示(Material Symbols)
[!NOTE] info
[!TIP] lightbulb
[!IMPORTANT] sms
[!WARNING] warning
[!CAUTION] error

輸出為 <blockquote class="WARNING">,第一行換成 <span class="hint"> 圖示加類型名稱。標記需全大寫;標準模式只會輸出 [!WARNING] 文字。

EN