---
title: Markdown 語法速查
nav: 語法速查
order: 2
description: 這個編輯器的預覽實際支援的語法，一頁看完：標題、強調、清單、表格、程式區塊、待辦清單。
updated: 2026-08-12
---

預覽使用 [marked.js](https://marked.js.org/) 解析，支援 GitHub Flavored Markdown（GFM）。
下面每一段的寫法都可以直接複製到編輯器裡試。

## 標題

```
# 一級標題
## 二級標題
### 三級標題
```

標題會自動取得錨點 id，所以預覽裡的標題可以被連結。

## 強調

```
**粗體** *斜體* ~~刪除線~~ `行內程式碼`
<u>底線</u>
```

Markdown 沒有底線語法，工具列的「底線」按鈕插入的是 HTML 的 `<u>` 標籤。
其他 Markdown 工具不一定支援它 —— 如果這份文件之後要餵給別的產生器，底線要小心用。

## 清單

```
- 項目
- 項目
  - 巢狀項目（縮排兩格）

1. 有序項目
2. 有序項目

- [x] 已完成的待辦
- [ ] 還沒做的待辦
```

## 連結與圖片

```
[顯示文字](https://example.com)
![替代文字](images/screenshot.png)
```

圖片路徑相對於**文件所在的資料夾**。因為預覽是在瀏覽器裡跑的，本機圖片只有在瀏覽器拿得到那個路徑時才顯示得出來；
比較保險的做法是用完整網址，或把圖片放在同一層資料夾。

## 引言與分隔線

```
> 引言可以連續好幾行，
> 每一行都加上大於符號。

---
```

## 表格

```
| 欄位 | 說明 | 數量 |
| --- | :---: | ---: |
| 左對齊 | 置中 | 右對齊 |
| a | b | 3 |
```

分隔列的冒號決定對齊：`:---` 左、`:---:` 置中、`---:` 右。
工具列的「表格」按鈕會問你要幾欄，然後把表頭與分隔列一次插入。

## 程式區塊

在程式碼前後各放一行三個反引號，開頭那行可以加語言名稱：

~~~
```js
const answer = 42;
```
~~~

預覽裡每個程式區塊的右上角都會出現**複製**按鈕，按一下整段進剪貼簿。

## 換行

Markdown 的單一換行**不會**變成換行。要換行有兩種寫法：

```
行尾留兩個空白後換行  
這樣就會斷行

或者中間空一整行，
變成兩個段落。
```

## 這個編輯器多做的一件事

檔案最前面的 YAML front matter 不會被當成分隔線或標題吃掉，而是渲染成一張獨立的卡片 ——
細節見[YAML front matter](/MDEditor/docs/front-matter)。
