Markdown 語法完全指南 2026 | 零基礎小白寫作入門

Markdown 語法完全指南

寫筆記、發博客、寫文檔……你還在用 Word 嗎？那你就 OUT 了！現在最流行的寫作方式是 Markdown——用簡單的符號就能排版，寫完直接可以放到網站上。這篇教程用大白話帶你從零掌握 Markdown。

一、Markdown 是什麼？

1.1 通俗理解

想象你用筆寫作文：

用 Word：寫一句，然後選中文字點「加粗」、選「字號」、調「字體」…邊寫邊點按鈕，很費事
用 Markdown：寫的時候順手加幾個符號，寫完格式就自動有了

比如要寫「這是加粗的文字」：

markdown

這是**加粗**的文字

就這麼簡單！不用任何按鈕，打兩個星號包起來就加粗了。

一句話總結：Markdown 是「寫的時候順手排版」的輕量級語言。

1.2 為什麼用 Markdown？

優勢	說明
純文本格式	什麼編輯器都能打開，永遠不會損壞
寫得快	手不用離開鍵盤，敲符號就能排版
兼容性強	GitHub、掘金、知乎、微信公眾號都支持
容易轉格式	一鍵轉 PDF、HTML、Word、電子書
專注內容	不用管樣式，專心寫就行

1.3 用什麼寫 Markdown？

你可以用這些工具（推薦從上往下選）：

工具	適合人群	說明
Typora	所有人	「所見即所得」，寫完立刻看到效果，最易用
Obsidian	筆記黨	雙鏈筆記、雙向鏈接，打造知識圖譜
VS Code	程序員	左邊寫 Markdown，右邊預覽
Notion	團隊協作	在線協作、數據庫功能強
任何文本編輯器	極簡主義	記事本也能寫 Markdown！

💡 新手建議：直接用 Typora，它是目前最像 Word 的 Markdown 編輯器，你邊寫邊看效果，零學習負擔。

二、標題（大小字號）

2.1 用 # 號表示標題

想要大小標題？在文字前加 # 號就行，# 越多，字越小：

markdown

# 一級標題（最大，類似 Word 的「標題 1」）
## 二級標題（類似「標題 2」）
### 三級標題
#### 四級標題
##### 五級標題
###### 六級標題（最小）

渲染效果：

一級標題（最大）

二級標題

三級標題

四級標題

五級標題

六級標題（最小）

💡 注意事項：
# 和文字之間要有一個空格
一篇文章只用一個 #（一級標題），通常就是文章標題
層級要按順序，不要從 # 直接跳到 ####

三、文字格式化

3.1 加粗、斜體、刪除線、高亮

用一對符號把文字包起來就行：

markdown

**這是加粗的文字**
*這是斜體的文字*
***這是加粗又斜體***
~~這是刪除線的文字~~
==這是高亮的文字==（部分編輯器支持）

渲染效果：

這是加粗的文字這是斜體的文字這是加粗又斜體~~這是刪除線的文字~~ ==這是高亮的文字==

💡 記憶技巧：
加粗 = 兩顆星 ** = 力度大
斜體 = 一顆星 * = 力度小
刪除線 = 兩條波浪 ~~ = 畫橫線劃掉
加粗斜體 = 三顆星 *** = 1+2

3.2 下劃線上標下標

下劃線、上標、下標在部分編輯器中支持：

markdown

++下劃線文字++（部分編輯器）

水的化學式：H~2~O  （下標，部分編輯器支持）
數學公式：x^2^ 表示 x 的平方（上標，部分編輯器支持）

如果編輯器不支持，可以直接用 HTML 標籤（Markdown 允許嵌入 HTML）：

html

<u>下劃線文字</u>
H<sub>2</sub>O
x<sup>2</sup>

3.3 分隔線

想要在兩段之間畫一條分隔線？連續寫三個（或更多）相同符號：

markdown

---（三個短橫線，最常用）
***（三個星號）
___（三個下劃線）

渲染效果：

💡 推薦用三個短橫線 ---，最好記。

四、列表

4.1 無序列表（小圓點/方塊）

用 *、+ 或 - 加空格，任意選一種都行：

markdown

* 蘋果
* 香蕉
* 橘子

- 也可以用短橫線
- 項目二
- 項目三

+ 或者用加號
+ 項目 A
+ 項目 B

渲染效果：

蘋果
香蕉
橘子

4.2 有序列表（123編號）

數字加英文點再加空格：

markdown

1. 打開冰箱門
2. 把大象放進去
3. 關上冰箱門

渲染效果：

打開冰箱門
把大象放進去
關上冰箱門

💡 小技巧：所有數字寫 1 也行，Markdown 會自動幫你編號：
markdown
1. 第一項
1. 第二項
1. 第三項
顯示出來還是 1、2、3，這樣調整順序時不用改數字！

4.3 嵌套列表

想做多級列表？按 Tab 縮進一層：

markdown

- 水果
  - 蘋果
    - 紅富士
    - 金帥
  - 香蕉
- 蔬菜
  - 番茄
    1. 紅色番茄
    2. 黃色番茄
  - 黃瓜

渲染效果：

水果
- 蘋果
  - 紅富士
  - 金帥
- 香蕉
蔬菜
- 番茄
  1. 紅色番茄
  2. 黃色番茄
- 黃瓜

💡 混合使用也完全沒問題！

4.4 任務列表（帶勾選框）

待辦事項專用，像 Todo 清單：

markdown

- [x] 買牛奶
- [x] 寫週報
- [ ] 鍛鍊身體
- [ ] 給媽媽打電話

渲染效果：

買牛奶
寫週報
鍛鍊身體
給媽媽打電話

💡 這個功能在 GitHub、Obsidian、Notion 裡特別常用，做項目管理或個人待辦非常方便。

五、引用塊

5.1 引用別人的話

用 > 加空格：

markdown

> 子曰：「學而時習之，不亦說乎？」

渲染效果：

子曰：「學而時習之，不亦說乎？」

5.2 多層嵌套引用

按兩個 >>、三個 >>> 就能嵌套：

markdown

> 第一層引用
>
>> 第二層引用
>>
>>> 第三層引用

渲染效果：

第一層引用
第二層引用
第三層引用

5.3 引用裡也能放其他格式

markdown

> # 標題也能放引用裡
>
> - 列表也能放
> - **加粗**和*斜體*也行
>
> 段落沒問題

六、鏈接和圖片

6.1 超鏈接

語法：[顯示文字](鏈接地址 "可選標題")

markdown

[去谷歌搜搜](https://www.google.com)

[點擊看關於頁面](/tw/about)

[打開百度](https://www.baidu.com "鼠標懸停時顯示的文字")

渲染效果：

去谷歌搜搜

6.2 自動鏈接

完整網址直接寫，會自動變成可點擊的鏈接：

markdown

我的博客：https://y-m.top

郵箱也可以：hello@example.com

6.3 圖片

和鏈接幾乎一樣，只是在最前面多加一個感嘆號 !：

markdown

![圖片描述文字](圖片地址)

![蘋果公司的Logo](https://www.apple.com/favicon.ico)

![加個標題](photo.jpg "鼠標懸停時顯示")

💡 圖片描述文字的作用：
圖片加載失敗時會顯示這段文字
盲人閱讀器會讀這段文字
搜索引擎靠這段文字識別圖片內容（SEO）

6.4 圖文鏈接

點擊圖片跳轉到一個網頁？把圖片語法嵌在鏈接語法裡：

markdown

[![圖片描述](圖片地址)](跳轉的鏈接地址)

[![點擊訪問蘋果官網](https://www.apple.com/favicon.ico)](https://www.apple.com)

七、代碼

7.1 行內代碼

把一小段代碼嵌在文字中間，用一對反引號（鍵盤左上角 ~ 那個鍵，也叫「重音符」）：

markdown

在 JavaScript 裡用 `console.log()` 來打印信息。

HTML 的標籤是 `<title>標題</title>`。

渲染效果：

在 JavaScript 裡用 console.log() 來打印信息。

HTML 的標籤是 <title>標題</title>。

7.2 代碼塊（多行代碼）

要寫大段代碼？用三個反引號包起來，開頭的反引號後面可以指定編程語言，方便顯示語法高亮：

```javascript
function sayHi(name) {
  console.log(`你好，${name}！`)
}
sayHi('小明')
```

渲染效果：

javascript

function sayHi(name) {
  console.log(`你好，${name}！`)
}
sayHi('小明')

💡 常用的語言標記： javascript、python、java、html、css、bash（命令行）、json、yaml、sql、go、rust、typescript、vue、jsx……

7.3 命令行示例

bash

# 安裝 pnpm
npm install -g pnpm

# 初始化項目
pnpm init

# 安裝依賴
pnpm install

💡 前面寫 # 的是註釋，代表「說明，不用執行」。

八、表格

8.1 基礎表格

用豎線 | 分隔每一列，用短橫線 --- 分隔表頭和內容：

markdown

| 姓名 | 年齡 | 城市 |
|------|------|------|
| 小明 | 25   | 北京 |
| 小紅 | 22   | 上海 |
| 小剛 | 28   | 廣州 |

渲染效果：

姓名	年齡	城市
小明	25	北京
小紅	22	上海
小剛	28	廣州

💡 對齊方式：
:--- = 左對齊（默認）
---: = 右對齊
:---: = 居中對齊
示例：
markdown
| 左對齊 | 居中 | 右對齊 |
|:-------|:----:|-------:|
| 蘋果   |  ¥5  |  100kg |

8.2 對齊方式示例

markdown

| 商品   | 單價  |  數量 |
|:-------|:-----:|------:|
| 蘋果   |  ¥5   |   100 |
| 香蕉   |  ¥3   |    50 |
| 橘子   |  ¥4   |    80 |

九、轉義字符

9.1 想顯示符號本身怎麼辦？

如果寫了一個星號但不想讓它變斜體？在符號前加反斜槓 \ 就行：

markdown

*這會是斜體*

\*這不會是斜體\*

\# 井號也能正常顯示

渲染效果：

這會是斜體

*這不會是斜體*

9.2 所有可以轉義的符號

markdown

\*   星號
\_   下劃線
\+   加號
\-   減號
\.   句號
\!   感嘆號
\#   井號
\|   豎線
\`   反引號
\[   方括號
\(   圓括號

十、實用擴展語法

不同編輯器支持不同的擴展功能，下面是幾個最常用的：

10.1 腳註

markdown

這是一段文字[^1]，後面有腳註。

[^1]: 這裡是腳註的詳細內容，一般會顯示在頁面底部。

10.2 目錄（自動生成）

markdown

@[TOC](目錄)

（或者單獨寫：）
[TOC]

很多編輯器（Typora、VS Code 插件）支持這個語法，會自動根據文章的標題生成一個可點擊的目錄。

10.3 提示框（Callout）

Obsidian 和一些靜態網站生成器（VitePress 等）支持：

markdown

> [!NOTE]
> 這是一個提示信息。

> [!TIP]
> 這是一個技巧提示。

> [!WARNING]
> 這是一個警告！

> [!DANGER]
> 這是危險操作！

10.4 Mermaid 流程圖

現代編輯器都支持用 Mermaid 語法直接畫圖，不用裝任何畫圖軟件：

```mermaid
graph TD
  A[起床] --> B[洗漱]
  B --> C[吃早飯]
  C --> D{今天上班嗎？}
  D -->|是| E[出門上班]
  D -->|否| F[在家休息]
```

渲染效果：

mermaid

graph TD
  A[起床] --> B[洗漱]
  B --> C[吃早飯]
  C --> D{今天上班嗎？}
  D -->|是| E[出門上班]
  D -->|否| F[在家休息]

💡 Mermaid 還能畫時序圖、餅圖、甘特圖、狀態機……非常強大！

十一、Markdown 寫作技巧

11.1 段落和換行

Markdown 裡，行末按兩個空格再回車才會換行，否則兩行會合併成一段：

markdown

這是第一行。
這是第二行。（這兩行會合在一起）

這是第三行。

這是第四行。（空一行就是新段落）

11.2 快捷鍵（打字更快）

在 Typora / Obsidian 裡，熟練用快捷鍵能快到飛起來：

快捷鍵	功能
Ctrl/Cmd + B	加粗
Ctrl/Cmd + I	斜體
Ctrl/Cmd + K	插入鏈接
Ctrl/Cmd + Shift + K	插入代碼塊
Ctrl/Cmd + 1~6	一到六級標題
Ctrl/Cmd + Enter	插入表格

11.3 文件命名

Markdown 文件後綴名是 .md（推薦）或 .markdown：

好的文件名：
  2026-08-07-markdown-guide.md
  my-first-blog-post.md
  讀書筆記_百年孤獨.md

不要用：
  文檔.md（太通用）
  新文檔 2.md（不知所云）

十二、實戰練習

12.1 練習一：寫一篇讀書筆記

markdown

# 《百年孤獨》讀書筆記

> 多年以後，奧雷里亞諾·布恩迪亞上校將會回想起父親帶他去見識冰塊的那個遙遠的下午。

## 基本信息

| 項目 | 內容 |
|------|------|
| 作者 | 加西亞·馬爾克斯 |
| 體裁 | 魔幻現實主義 |
| 字數 | 約26.2萬 |
| 閱讀時間 | 2026.07.20 - 2026.08.01 |

## 主要人物

1. **何塞·阿爾卡蒂奧·布恩迪亞**：馬孔多的創建者
2. **烏爾蘇拉**：家族的支柱
3. **奧雷里亞諾上校**：發動32場武裝起義
   - 每一場都失敗了
   - 最後被遺忘

## 讀書筆記

### 關於孤獨

> 生命中真正重要的不是你遭遇了什麼，而是你記住了哪些事，以及你是如何銘記的。

布恩迪亞家族的孤獨來自於：

* 不懂得去愛
* 陷入重複的命運輪迴
* 無法溝通與理解

### 關於魔幻現實主義

作者把現實和虛構混在一起，讀的時候會覺得：
- `時間` 是循環的
- `命運` 是重複的
- `記憶` 是被遺忘的

## 好句摘抄

1. 過去都是假的，回憶是一條沒有歸途的路。
2. 買下一張永久車票，登上一列永不抵達的火車。
3. 生命中曾經有過的所有燦爛，終究都需要用寂寞來償還。

## 我的評分

- [x] 故事性：⭐⭐⭐⭐⭐
- [x] 文筆：⭐⭐⭐⭐⭐
- [x] 思想深度：⭐⭐⭐⭐⭐
- [ ] 易讀性：⭐⭐⭐（人名多，記起來費勁）

12.2 練習二：寫一篇技術教程結構

markdown

# 從零開始學 Vue 3

## 1. 環境準備

### 1.1 安裝 Node.js

去官網下載安裝包：[https://nodejs.org](https://nodejs.org)

檢查是否安裝成功：

```bash
node -v
npm -v

1.2 創建項目

bash

npm create vue@latest
cd my-vue-app
npm install
npm run dev

2. 基本概念

Vue 的三大核心：

響應式數據：用 ref() 包起來
組件化：把頁面拆成一個個小組件
組合式 API：用 Composition API 組織代碼

3. 示例代碼

vue

<script setup>
import { ref } from 'vue'

const count = ref(0)
const double = () => count.value * 2
</script>

<template>
  <h1>計數器</h1>
  <p>當前數值：{{ count }}</p>
  <p>雙倍數值：{{ double() }}</p>
  <button @click="count++">加 1</button>
</template>

4. 推薦閱讀

資源	說明
Vue 官方文檔	最權威
Vue 3 Composition API 最佳實踐	本網站教程
Vite 完全指南	構建工具教程


---

## 十三、常見問題

### 13.1 Markdown 和 Word 哪個好？

| 場景 | 推薦 |
|------|------|
| 寫代碼/技術文檔/博客/筆記 | **Markdown** ✅ |
| 寫合同/簡歷/正式公文/需要大量排版 | Word ✅ |

### 13.2 微信公眾號支持 Markdown 嗎？

原生不支持，但可以用這些工具轉：

- **Markdown Nice**：在線轉公眾號排版
- **墨滴**：Markdown 轉公眾號
- **Typora**：複製粘貼到公眾號

### 13.3 寫 Markdown 時，圖片放哪裡？

幾個方案：

1. **本地文件夾**：`./images/photo.jpg`（本地筆記）
2. **GitHub 倉庫**：免費，可公開訪問（本網站用的就是這個）
3. **圖床**：SM.MS、PicList + GitHub 等（免費，適合博客）
4. **Obsidian 附件**：自動存本地文件夾

---

## 十四、Markdown 速查表

### 14.1 常用語法速查

| 語法 | 效果 | 代碼 |
|------|------|------|
| **加粗** | 加粗 | `**加粗**` |
| *斜體* | 斜體 | `*斜體*` |
| ~~刪除線~~ | 刪除線 | `~~刪除線~~` |
| `代碼` | 代碼 | `` `代碼` `` |
| [鏈接](url) | 鏈接 | `[文字](url)` |
| ![圖](url) | 圖片 | `![描述](url)` |
| > 引用 | 引用塊 | `> 引用文字` |
| 無序列表 | - 項目 | `- 項目` |
| 有序列表 | 1. 項目 | `1. 項目` |
| 任務列表 | - [x] 已完成 | `- [x] 任務` |

### 14.2 快捷鍵速查（Typora）

| 功能 | 快捷鍵 |
|------|--------|
| 加粗 | Ctrl/Cmd + B |
| 斜體 | Ctrl/Cmd + I |
| 標題1~6 | Ctrl/Cmd + 1~6 |
| 鏈接 | Ctrl/Cmd + K |
| 圖片 | Ctrl/Cmd + Shift + I |
| 代碼塊 | Ctrl/Cmd + Shift + K |
| 表格 | Ctrl/Cmd + T |
| 引用 | Ctrl/Cmd + Shift + Q |
| 查找替換 | Ctrl/Cmd + F / H |

---

## 十五、總結

回顧本教程的要點：

1. **標題**：用 `#` 號，1 個最大，6 個最小
2. **加粗**：兩顆星 `**`，斜體一顆星 `*`
3. **刪除線**：兩個波浪 `~~`
4. **列表**：`-` 無序，`1.` 有序，`[ ]` 任務清單
5. **引用**：用 `>` 號，`>>` 嵌套
6. **鏈接**：`[文字](地址)`，圖片前面加個 `!`
7. **代碼**：一對反引號行內，三對反引號代碼塊
8. **表格**：`|` 分隔列，`---` 分隔表頭，對齊用 `:`
9. **換行**：行末兩個空格，新段落空一行
10. **轉義**：符號前加反斜槓 `\`

Markdown 就是這麼簡單！今天起，把你的筆記、博客、文檔都換成 Markdown 吧，你會發現寫作從未如此輕鬆。

---

**相關閱讀：**
- [VS Code 使用技巧](/tw/notes/vscode)
- [Obsidian + Git + VitePress 知識管理工作流](/tw/notes/knowledge-management-workflow)
- [PicGo/PicList + GitHub 圖床搭建教程](/tw/notes/build-picture-bed)
- [HTML5 基礎入門教程](/tw/fe/html/html5-beginner-guide)
- [JavaScript 基礎入門教程](/tw/fe/javascript/javascript-beginner-guide)

Markdown 語法完全指南 2026 | 零基礎小白寫作入門 ​

一、Markdown 是什麼？ ​

1.1 通俗理解 ​

1.2 為什麼用 Markdown？ ​

1.3 用什麼寫 Markdown？ ​

二、標題（大小字號） ​

2.1 用 # 號表示標題 ​

一級標題（最大） ​

二級標題 ​

三級標題 ​

四級標題 ​

五級標題 ​

六級標題（最小） ​

三、文字格式化 ​

3.1 加粗、斜體、刪除線、高亮 ​

3.2 下劃線上標下標 ​

3.3 分隔線 ​

四、列表 ​

4.1 無序列表（小圓點/方塊） ​

4.2 有序列表（123編號） ​

4.3 嵌套列表 ​

4.4 任務列表（帶勾選框） ​

五、引用塊 ​

5.1 引用別人的話 ​

5.2 多層嵌套引用 ​

5.3 引用裡也能放其他格式 ​

六、鏈接和圖片 ​

6.1 超鏈接 ​

6.2 自動鏈接 ​

6.3 圖片 ​

6.4 圖文鏈接 ​

七、代碼 ​

7.1 行內代碼 ​

7.2 代碼塊（多行代碼） ​

7.3 命令行示例 ​

八、表格 ​

8.1 基礎表格 ​

8.2 對齊方式示例 ​

九、轉義字符 ​

9.1 想顯示符號本身怎麼辦？ ​

9.2 所有可以轉義的符號 ​

十、實用擴展語法 ​

10.1 腳註 ​

10.2 目錄（自動生成） ​

10.3 提示框（Callout） ​

10.4 Mermaid 流程圖 ​

十一、Markdown 寫作技巧 ​

11.1 段落和換行 ​

11.2 快捷鍵（打字更快） ​

11.3 文件命名 ​

十二、實戰練習 ​

12.1 練習一：寫一篇讀書筆記 ​

12.2 練習二：寫一篇技術教程結構 ​

1.2 創建項目 ​

2. 基本概念 ​

3. 示例代碼 ​

4. 推薦閱讀 ​

Markdown 語法完全指南 2026 | 零基礎小白寫作入門

一、Markdown 是什麼？

1.1 通俗理解

1.2 為什麼用 Markdown？

1.3 用什麼寫 Markdown？

二、標題（大小字號）

2.1 用 # 號表示標題

一級標題（最大）

二級標題

三級標題

四級標題

五級標題

六級標題（最小）

三、文字格式化

3.1 加粗、斜體、刪除線、高亮

3.2 下劃線上標下標

3.3 分隔線

四、列表

4.1 無序列表（小圓點/方塊）

4.2 有序列表（123編號）

4.3 嵌套列表

4.4 任務列表（帶勾選框）

五、引用塊

5.1 引用別人的話

5.2 多層嵌套引用

5.3 引用裡也能放其他格式

六、鏈接和圖片

6.1 超鏈接

6.2 自動鏈接

6.3 圖片

6.4 圖文鏈接

七、代碼

7.1 行內代碼

7.2 代碼塊（多行代碼）

7.3 命令行示例

八、表格

8.1 基礎表格

8.2 對齊方式示例

九、轉義字符

9.1 想顯示符號本身怎麼辦？

9.2 所有可以轉義的符號

十、實用擴展語法

10.1 腳註

10.2 目錄（自動生成）

10.3 提示框（Callout）

10.4 Mermaid 流程圖

十一、Markdown 寫作技巧

11.1 段落和換行

11.2 快捷鍵（打字更快）

11.3 文件命名

十二、實戰練習

12.1 練習一：寫一篇讀書筆記

12.2 練習二：寫一篇技術教程結構

1.2 創建項目

2. 基本概念

3. 示例代碼

4. 推薦閱讀