# 標題、分隔線與引用

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

## 標題

| 寫法 | 輸出 |
|---|---|
| `# 文字` ～ `###### 文字` | `<h1>` ～ `<h6>` |
| `文字` 下一行 `===`（3 個以上） | `<h1>` |
| `文字` 下一行 `---`（3 個以上） | `<h2>` |
| 表格儲存格內 `\| ## 文字 \|` | 儲存格內的 `<h2>` |

| 規則 | 說明 |
|---|---|
| `#` 後需有空白 | `#tag` 不是標題，可能成為 [Hashtag 連結](/hashtag-links) |
| 允許前導 | 行首空白、`> `、列表記號（`- `、`1. `）之後的 `#` 也會成為標題 |
| 跳脫 | `\# 文字` 不轉換 |
| 不產生 id | 標題沒有 `id` 屬性，無法以錨點連結 |

## 水平分隔線

獨立一行的 `---` 或 `***`（3 個以上，前後可有空白）輸出 `<hr>`。

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

## 引用

```markdown
> 第一層
>> 第二層
> - 引用內的列表
```

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

## 提示框

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

```markdown
> [!WARNING]
> 這個動作無法復原
```

| 標記 | 圖示（Material Symbols） |
|---|---|
| `[!NOTE]` | `info` |
| `[!TIP]` | `lightbulb` |
| `[!IMPORTANT]` | `sms` |
| `[!WARNING]` | `warning` |
| `[!CAUTION]` | `error` |

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