Markdown 語法教學:從標題到表格,一頁學會
Markdown 是一種用純文字寫出「有格式文件」的方法。你只要在文字前後加上幾個符號,例如 #、*、-,閱讀器就會把它排成標題、粗體與清單。README、技術文件、部落格、筆記軟體(Notion、Obsidian、HackMD)都使用 Markdown,學一次就能到處用。
這篇教學整理最常用的語法,每一段都附上範例。寫好的 .md 檔可以直接拖進墨閱線上 Markdown 閱讀器預覽排版結果。
標題
在行首加上 #,數量代表層級,# 是最大的標題,最多到 ######。# 後面要留一個空格。
# 文件標題
## 第一章
### 1.1 小節
一份文件通常只放一個 # 大標題,其餘用 ##、### 分層。墨閱會依照標題自動產生右側目錄。
段落與換行
連續的文字會被視為同一段。想開新段落,中間空一行即可。若只想換行不分段,可以在行尾加兩個空格,或直接空一行。
粗體、斜體與刪除線
**粗體文字**
*斜體文字*
~~刪除線~~
`行內程式碼`
中文排版建議少用斜體,用 粗體 強調重點會更清楚。
清單
無序清單用 -、* 或 + 開頭;有序清單用數字加句點。縮排兩到四個空格可以做出巢狀清單。
- 蘋果
- 香蕉
- 芭樂(巢狀項目)
1. 先打開檔案
2. 再選擇主題
3. 開始閱讀
工作清單
GitHub 風格 Markdown(GFM)支援勾選框,很適合寫待辦事項:
- [x] 完成大綱
- [ ] 補上範例
- [ ] 校對錯字
連結與圖片
[墨閱](https://md-viewer.amemori.win/)

圖片語法比連結多一個驚嘆號。替代文字 會在圖片無法顯示時出現,也能幫助螢幕閱讀器與搜尋引擎理解圖片內容。在墨閱中使用「開啟資料夾」,文件引用的本機圖片就能正常顯示。
引用
在行首加上 >,適合放引文、提醒或重點摘要:
> 留白之間,自有風景。
程式碼區塊
用三個反引號包住程式碼,並在開頭標註語言名稱,就能得到語法高亮:
```javascript
const total = [1, 2, 3].reduce((a, b) => a + b, 0);
console.log(total);
```
墨閱支援上百種語言的高亮。標註為 javascript 的程式碼還能按「▷ 執行」在安全沙盒中執行並查看結果。
表格
用 | 分隔欄位,第二行用 --- 分隔表頭。冒號可以控制對齊方式。
| 功能 | 快捷鍵 | 說明 |
| :--- | :---: | ---: |
| 開啟文件 | Ctrl O | 選擇 .md 檔 |
| 搜尋內文 | Ctrl F | 找出關鍵字 |
:--- 靠左、:---: 置中、---: 靠右。
分隔線與跳脫字元
三個以上的 - 或 * 會變成分隔線。若想顯示 *、# 這類符號本身,在前面加上反斜線 \ 即可,例如 \*不是斜體\*。
進階:圖表與數學公式
標準 Markdown 不包含圖表與公式,但很多工具都支援以下兩種延伸語法,墨閱也完整支援:
- Mermaid 圖表:用文字畫流程圖、循序圖、甘特圖,請看 Mermaid 圖表教學。
- LaTeX 數學公式:用
$...$與$$...$$寫出漂亮的數學式,請看 LaTeX 數學公式教學。
Markdown 語法速查表
| 想要的效果 | 寫法 |
|---|---|
| 標題 | # 標題 |
| 粗體 | **文字** |
| 斜體 | *文字* |
| 刪除線 | ~~文字~~ |
| 連結 | [文字](網址) |
| 圖片 |  |
| 無序清單 | - 項目 |
| 有序清單 | 1. 項目 |
| 工作清單 | - [ ] 待辦 |
| 引用 | > 引文 |
| 行內程式碼 | `code` |
| 分隔線 | --- |
寫完了嗎?把檔案拖進墨閱,就能看到排版後的樣子,也可以直接另存成 PDF 分享給別人。