為什麼你應該知道 Markdown?
在資訊爆炸與跨平台溝通的時代,能夠快速撰寫清晰、結構化的內容是一項關鍵技能。Markdown 作為一種輕量級標記語言,讓使用者以最簡潔的方式撰寫格式化文件,並能無縫轉換為 HTML、PDF、Word 等格式。無論你是工程師撰寫 README、部落客撰寫文章、教育工作者製作教材,甚至是日常筆記愛好者,Markdown 都能提供一致、可讀、可維護的內容架構。
這篇文章將完整整理 Markdown 的所有語法,從基本標題、清單、連結,到進階的表格、程式碼區塊、LaTeX數學公式與平台擴充語法,並搭配範例與應用建議,協助你快速掌握並靈活運用。無論你是初學者還是進階使用者,都能在這份語法大全中找到實用指引。
一、標題(Heading)
使用#
表示標題層級,最多支援六層。# 標題一(H1)
## 標題二(H2)
### 標題三(H3)
#### 標題四(H4)
##### 標題五(H5)
###### 標題六(H6)
二、段落與換行(Paragraph & Line Break)
段落之間需空一行。若要強制換行,可在行尾加兩個空格。[Tab]縮排
這是第一段。
這是第二段。
這是同一段中的換行。
三、文字樣式(Text Formatting)

四、清單(List)
無序清單(Unordered List)
使用 -
、*
或 +
開頭皆可。
- 項目一
- 項目二
- 子項目
有序清單(Ordered List)
使用數字加句點。
1. 第一項
2. 第二項
1. 子項目
五、連結與圖片(Links & Images)
連結
[顯示文字](https://example.com)
圖片

📌 注意:圖片語法與連結語法相同,只是前面多了 !
。
六、引用(Blockquote)
使用 >
表示引用段落。
> 這是一段引用文字。
>> 這是巢狀引用。
七、程式碼(Code)
行內程式碼(Inline Code)
使用反引號 `
包住。
請使用 `npm install` 安裝套件。
區塊程式碼(Code Block)
使用三個反引號 ``` 或縮排四個空格。
```python
def hello():
print("Hello Markdown")
八、分隔線(Horizontal Rule)
使用三個以上的 `-`、`*` 或 `_`。
```markdown
---
***
___
九、表格(Table)
使用 |
與 -
建立表格。
| 欄位一 | 欄位二 |
|--------|--------|
| 資料一 | 資料二 |
| 資料三 | 資料四 |
可加入對齊方式:
| 左對齊 | 置中 | 右對齊 |
|:-------|:----:|-------:|
| A | B | C |
十、註解與跳脫字元(Comment & Escape)
註解(HTML 語法)
<!-- 這是一段註解 -->
跳脫特殊字元
使用反斜線 \
跳脫 Markdown 保留字。
\*這不是斜體\*
十一、目錄與錨點(TOC & Anchor)
部分平台(如 GitHub)會自動根據標題生成目錄。若需手動錨點連結:
[跳至某段落](#標題名稱)
標題名稱需轉為小寫並以 -
取代空格。
十二、任務清單(Task List)
GitHub、Obsidian 等平台支援任務清單語法:
- [ ] 未完成項目
- [x] 已完成項目
十三、折疊區塊(Details / Collapse)
部分平台支援 HTML <details>
標籤,用於折疊內容:
<details>
<summary>點我展開</summary>
這是折疊內容。
</details>
十四、數學公式(LaTeX)
在支援 LaTeX 的平台(如 Jupyter、Obsidian)可使用 $...$
或 $$...$$
:
行內公式:$E = mc^2$
區塊公式:
$$
\int_a^b f(x)\,dx = F(b) - F(a)
$$
十五、腳註(Footnote)
部分平台支援腳註語法:
這是一段文字[^1]。
[^1]: 這是腳註內容。
十六、內嵌 HTML(HTML Embedding)
Markdown 可與 HTML 混用,補足格式控制:
<span style="color: red;">紅色文字</span>
十七、表情符號(Emoji)
GitHub 等平台支援 emoji 語法:
:smile: :rocket: :warning:
十八、自動目錄(TOC)
部分平台(如 Obsidian)支援自動生成目錄:
[TOC]
十九、引用他人帳號或 Issue(GitHub 特有)
@username
#123 (Issue 或 Pull Request 編號)
二十、程式碼語法高亮(Syntax Highlighting)
在程式碼區塊中指定語言可啟用語法高亮:
```javascript
function greet() {
console.log("Hello Markdown");
}
程式碼
---
## 二十三、目標連結與錨點(Anchor)
可建立頁面內跳轉連結:
```markdown
[跳至某段落](#段落標題)
標題需轉為小寫並以 -
取代空格。
結語 : Markdown 是簡潔與效率的語言,值得每位內容創作者掌握
Markdown 的魅力在於「簡單但不簡化」。它不依賴複雜的編輯器,卻能產出結構清晰、格式一致的內容。從技術文件到教學教材,從筆記工具到網站內容管理,Markdown 已成為現代數位寫作的通用語言。
掌握 Markdown,不只是學會一套語法,更是建立一種思維:以結構為核心、以可讀性為優先、以跨平台為目標。當你熟悉 Markdown 的語法與特性後,你將能更快速地撰寫、維護並分享內容,無論是在個人筆記、團隊協作或公開發表中都能受益。
你目前掌握的語法已涵蓋 Markdown 的核心功能,但若你要在特定平台(如 GitHub、Obsidian、Jupyter)進行進階應用,還可探索其擴充語法與插件支援。