Markdown 語法教學:從標題到表格,一頁學會

Markdown 是一種用純文字寫出「有格式文件」的方法。你只要在文字前後加上幾個符號,例如 #、*、-,閱讀器就會把它排成標題、粗體與清單。README、技術文件、部落格、筆記軟體(Notion、Obsidian、HackMD)都使用 Markdown,學一次就能到處用。

這篇教學整理最常用的語法,每一段都附上範例。寫好的 .md 檔可以直接拖進墨閱線上 Markdown 閱讀器預覽排版結果。

標題

在行首加上 #,數量代表層級,# 是最大的標題,最多到 ######。# 後面要留一個空格。

# 文件標題
## 第一章
### 1.1 小節

一份文件通常只放一個 # 大標題,其餘用 ##、### 分層。墨閱會依照標題自動產生右側目錄。

段落與換行

連續的文字會被視為同一段。想開新段落,中間空一行即可。若只想換行不分段,可以在行尾加兩個空格,或直接空一行。

粗體、斜體與刪除線

**粗體文字**
*斜體文字*
~~刪除線~~
`行內程式碼`

中文排版建議少用斜體,用 粗體 強調重點會更清楚。

清單

無序清單用 -、* 或 + 開頭;有序清單用數字加句點。縮排兩到四個空格可以做出巢狀清單。

- 蘋果
- 香蕉
  - 芭樂(巢狀項目)

1. 先打開檔案
2. 再選擇主題
3. 開始閱讀

工作清單

GitHub 風格 Markdown(GFM)支援勾選框,很適合寫待辦事項:

- [x] 完成大綱
- [ ] 補上範例
- [ ] 校對錯字

連結與圖片

[墨閱](https://md-viewer.amemori.win/)
![替代文字](images/photo.png)

圖片語法比連結多一個驚嘆號。替代文字 會在圖片無法顯示時出現,也能幫助螢幕閱讀器與搜尋引擎理解圖片內容。在墨閱中使用「開啟資料夾」,文件引用的本機圖片就能正常顯示。

引用

在行首加上 >,適合放引文、提醒或重點摘要:

> 留白之間,自有風景。

程式碼區塊

用三個反引號包住程式碼,並在開頭標註語言名稱,就能得到語法高亮:

```javascript
const total = [1, 2, 3].reduce((a, b) => a + b, 0);
console.log(total);
```

墨閱支援上百種語言的高亮。標註為 javascript 的程式碼還能按「▷ 執行」在安全沙盒中執行並查看結果。

表格

用 | 分隔欄位,第二行用 --- 分隔表頭。冒號可以控制對齊方式。

| 功能 | 快捷鍵 | 說明 |
| :--- | :---: | ---: |
| 開啟文件 | Ctrl O | 選擇 .md 檔 |
| 搜尋內文 | Ctrl F | 找出關鍵字 |

:--- 靠左、:---: 置中、---: 靠右。

分隔線與跳脫字元

三個以上的 - 或 * 會變成分隔線。若想顯示 *、# 這類符號本身,在前面加上反斜線 \ 即可,例如 \*不是斜體\*。

進階:圖表與數學公式

標準 Markdown 不包含圖表與公式,但很多工具都支援以下兩種延伸語法,墨閱也完整支援:

Markdown 語法速查表

想要的效果 寫法
標題 # 標題
粗體 **文字**
斜體 *文字*
刪除線 ~~文字~~
連結 [文字](網址)
圖片 ![說明](路徑)
無序清單 - 項目
有序清單 1. 項目
工作清單 - [ ] 待辦
引用 > 引文
行內程式碼 `code`
分隔線 ---

寫完了嗎?把檔案拖進墨閱,就能看到排版後的樣子,也可以直接另存成 PDF 分享給別人。