標題、分隔線與引用
本頁說明標題、水平分隔線、引用區塊與 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] 文字。