Skip to content

Markdown 擴展語法

基本的 Markdown 語法提供了創建文檔所需的基本元素,但對於某些特定需求來說還不夠。這就是擴展語法的用武之地。

擴展語法是在基本語法基礎上添加的額外功能,讓你能夠創建更豐富、更復雜的文檔。

什麼是擴展語法?

擴展語法是指超出原始 Markdown 規范的語法元素。這些擴展由不同的 Markdown 處理器添加,用於支持額外的功能。

常見的擴展語法

  • 表格 - 創建數據表格
  • 圍欄代碼塊 - 帶語法高亮的代碼塊
  • 腳注 - 添加腳注引用
  • 標題 ID - 為標題添加自定義 ID
  • 定義列表 - 術語和定義的列表
  • 刪除線 - 劃掉文本
  • 任務列表 - 帶復選框的清單
  • emoji - 表情符號
  • 高亮 - 突出顯示文本
  • 下標和上標 - 數學公式中常用

支持情況

需要注意的是,不是所有 Markdown 應用程序都支持擴展語法。使用前需要確認你的 Markdown 處理器是否支持你想使用的擴展語法。

主流支持

以下平台和工具較好地支持擴展語法:

  • GitHub Flavored Markdown (GFM) - GitHub 的 Markdown 擴展
  • GitLab Flavored Markdown - GitLab 的擴展
  • Typora - 富文本 Markdown 編輯器
  • Obsidian - 知識管理工具
  • VitePress - 靜態站點生成器
  • Hugo - 靜態站點生成器

表格

創建表格是最常用的擴展語法之一:

markdown
| 姓名 | 年齡 | 職業 |
|------|------|------|
| 張三 | 25   | 工程師 |
| 李四 | 30   | 設計師 |
姓名年齡職業
張三25工程師
李四30設計師

圍欄代碼塊

帶語法高亮的代碼塊:

markdown
```javascript
function hello() {
    console.log("Hello, World!");
}
```
javascript
function hello() {
    console.log("Hello, World!");
}

任務列表

創建待辦事項清單:

markdown
- [x] 完成項目計劃
- [ ] 編寫代碼
- [ ] 測試功能
- [ ] 部署上線
  • [x] 完成項目計劃
  • [ ] 編寫代碼
  • [ ] 測試功能
  • [ ] 部署上線

刪除線

表示已刪除或不正確的內容:

markdown
~~這段文字有刪除線~~

這段文字有刪除線

自動鏈接

自動識別 URL 和郵箱地址:

markdown
訪問 https://markdown.com.cn 了解更多信息。
聯系郵箱:example@domain.com

訪問 https://markdown.com.cn 了解更多信息。 聯系郵箱:example@domain.com

腳注

為文檔添加注釋和參考:

markdown
這裡有一個腳注的例子[^1]。

[^1]: 這是腳注的內容。

這裡有一個腳注的例子^1

定義列表

創建術語和定義的列表:

markdown
Markdown
:   一種輕量級標記語言

HTML
:   超文本標記語言
:   用於創建網頁的標准標記語言

數學公式

支持 LaTeX 風格的數學公式:

markdown
行內公式:$E = mc^2$

塊級公式:
$$
\sum_{i=1}^n a_i = 0
$$

圖表和流程圖

一些高級編輯器支持 Mermaid 圖表:

markdown
```mermaid
graph TD
    A[開始] --> B{是否理解?}
    B -->|是| C[繼續學習]
    B -->|否| D[重新閱讀]
    D --> B
    C --> E[結束]
```

擴展語法學習路徑

建議按以下順序學習擴展語法:

  1. 表格 - 最常用和實用
  2. 圍欄代碼塊 - 程序員必備
  3. 任務列表 - 項目管理利器
  4. 刪除線 - 簡單易用
  5. 腳注 - 學術寫作需要
  6. 定義列表 - 術語解釋
  7. 標題 ID - 高級鏈接
  8. 高亮 - 強調重點

兼容性注意事項

在使用擴展語法時:

  • 測試兼容性 - 在目標平台上測試你的 Markdown
  • 提供備用方案 - 考慮在不支持擴展語法的平台上的顯示效果
  • 文檔說明 - 在文檔中說明使用了哪些擴展語法
  • 標准化選擇 - 團隊內統一使用的擴展語法標准

下一步

選擇你感興趣的擴展語法開始學習:

由 Markdownlang.com 整理創建