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[結束]
```
擴展語法學習路徑
建議按以下順序學習擴展語法:
兼容性注意事項
在使用擴展語法時:
- 測試兼容性 - 在目標平台上測試你的 Markdown
- 提供備用方案 - 考慮在不支持擴展語法的平台上的顯示效果
- 文檔說明 - 在文檔中說明使用了哪些擴展語法
- 標准化選擇 - 團隊內統一使用的擴展語法標准
下一步
選擇你感興趣的擴展語法開始學習: