Markdown 語法指南:常用的排版技巧都在這
The LoveMarkdown TeamPublished
這篇指南會帶你從基礎的文字格式到進階的排版技巧,把常用的 Markdown 語法全部走一遍。每個段落都有可以直接複製貼上的範例。
換行
這是最多人問的問題之一:怎麼在 Markdown 裡換行?跟一般文書處理器不同,Markdown 裡按一次 Enter 不會真的換行。
這是第一行··(行末加兩個空白)
這是第二行
— 或者用反斜線 —
這是第一行\
這是第二行
— 或者直接寫 HTML —
這是第一行<br>
這是第二行新段落:只要在兩段文字之間留一行空白就行了。
引用區塊
> 這是一段引用。
> 可以跨多行。
> **巢狀引用**
>> 這是內層引用。
> 引用裡面也能用其他 **Markdown** 格式:
> - 清單
> - *強調*
> - `程式碼`粗體、斜體、底線
**粗體文字** → 粗體
*斜體文字* → 斜體
***粗體加斜體*** → 兩者都有
__底線方式粗體__
_底線方式斜體_
底線:<u>底線文字</u>(用 HTML 標籤)項目符號與清單
## 無序清單
- 用短橫線
* 用星號
+ 用加號
## 巢狀清單
- 父項目
- 子項目
- 孫項目
## 有序清單
1. 第一項
2. 第二項
3. 第三項
## 任務清單(GitHub Flavored)
- [x] 已完成
- [ ] 未完成分隔線
---
***
___文字對齊與置中
<div align="center">
這段文字會置中顯示。
</div>
— 或者 —
<center>置中文字</center>表格
| 靠左 | 置中 | 靠右 |
|:-----|:------:|------:|
| L1 | C1 | R1 |
| L2 | C2 | R2 |註解
Markdown 沒有官方的註解語法,但以下幾種寫法都很常用:
[comment]: <> (這段註解不會出現在輸出中)
<!-- HTML 註解也可以用 -->
[//]: # (另一種註解寫法)下標與上標
標準 Markdown 沒有下標和上標的語法,得用 HTML:
H<sub>2</sub>O → H₂O
E = mc<sup>2</sup> → E = mc²縮排
## 程式碼區塊的縮排
4 個半形空格或 1 個 Tab 就會變成程式碼區塊。
## 清單的縮排
- 父項目
- 子項目用 2 個空格
- 孫項目用 4 個空格
## 段落縮排
用 HTML 的不換行空格來做首行縮排。轉換工具
- Markdown → PDF — 帶樣式的文件
- Markdown → Word — 可編輯的 .docx
- Markdown → HTML — 網頁用 HTML
- Markdown → 圖片 — 可分享的 PNG
常見問題
Markdown 怎麼換行?
在行末放兩個以上的半形空格,或者加一個反斜線再按 Enter。只按 Enter 的話,Markdown 會把前後行合併成同一段落。反之,中間留一行空白就會分成兩個段落。
為什麼我的 Markdown 語法沒生效?
最常見的三個原因:區塊元素前面沒留空行、縮排混用了 Tab 和空格、或者你用的渲染器不支援那個語法。Markdown 有很多「方言」,表格、任務清單、刪除線這些是 GitHub Flavored Markdown 的擴展,原始規格裡沒有。
Markdown 怎麼跳脫特殊字元?
在字元前面加一個反斜線。\* 就不會開始斜體,而是直接顯示星號本身。\# 也一樣,不會變成標題而是顯示井號。Markdown 語法用到的標點符號(\ ` * _ { } [ ] ( ) # + - . !)都可以這樣跳脫。
Markdown 支援表格嗎?
原始規格沒有,表格是 GitHub Flavored Markdown 加入的功能,現在已經被廣泛支援。用冒號來指定對齊方式(:--- 靠左、:---: 置中、---: 靠右)。