Markdown 語法速查

預覽使用 marked.js 解析,支援 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

下載這一頁的 .md 原始檔 用編輯器打開它,就是一份現成的範例文件。

← 回手冊目錄