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 個空格

## 段落縮排
&nbsp;&nbsp;&nbsp;&nbsp;用 HTML 的不換行空格來做首行縮排。

轉換工具

常見問題

Markdown 怎麼換行?

在行末放兩個以上的半形空格,或者加一個反斜線再按 Enter。只按 Enter 的話,Markdown 會把前後行合併成同一段落。反之,中間留一行空白就會分成兩個段落。

為什麼我的 Markdown 語法沒生效?

最常見的三個原因:區塊元素前面沒留空行、縮排混用了 Tab 和空格、或者你用的渲染器不支援那個語法。Markdown 有很多「方言」,表格、任務清單、刪除線這些是 GitHub Flavored Markdown 的擴展,原始規格裡沒有。

Markdown 怎麼跳脫特殊字元?

在字元前面加一個反斜線。\* 就不會開始斜體,而是直接顯示星號本身。\# 也一樣,不會變成標題而是顯示井號。Markdown 語法用到的標點符號(\ ` * _ { } [ ] ( ) # + - . !)都可以這樣跳脫。

Markdown 支援表格嗎?

原始規格沒有,表格是 GitHub Flavored Markdown 加入的功能,現在已經被廣泛支援。用冒號來指定對齊方式(:--- 靠左、:---: 置中、---: 靠右)。