Markdown 筆記：從入門到高效實戰的完整指南

說到用 Markdown 做筆記（markdown note taking），很多人的第一反應是「這不就是程式設計師寫程式碼文件用的嗎？」。其實 Markdown 記筆記這件事，門檻比你想的低得多，效率也比你想的高得多。

我最早接觸 Markdown 是 2018 年，當時在 Evernote 裡寫技術筆記，格式亂得一塌糊塗。後來切到 Markdown，發現幾行簡單的符號就能把筆記結構梳理得清清楚楚，再也沒回去過。這篇文章把這幾年用 Markdown 記筆記的經驗整理出來，從基本語法到筆記模板，再到軟體選擇，一次性講清楚。

Markdown 筆記示例

為什麼用 Markdown 做筆記

在聊具體怎麼用之前，先說說為什麼 Markdown 適合記筆記。

格式和內容分離，專注寫作本身

用 Word 或富文字編輯器記筆記時，你經常要花時間調字體、調間距、對齊段落。Markdown 用簡單的文字符號代替格式按鈕——# 是標題，** 是加粗，- 是列表。你只需要關注內容，格式在渲染時自動產生。

純文字，走到哪都能用

Markdown 檔案本質上是純文字（.md 後綴），不依賴任何特定軟體。你在 Obsidian 裡寫的筆記，用記事本也能打開；換一台電腦，隨便找一個 Markdown 編輯器就能繼續編輯。不用擔心「這個軟體不相容那個格式」的問題。

版本管理天然友好

因為 Markdown 是純文字，配合 Git 做版本管理非常方便。每一次修改都有記錄，隨時回退到任意版本。對於長期維護的知識庫來說，這一點太重要了。

參考：Markdown Guide 指出，Markdown 的設計初衷就是「易讀易寫的純文字格式」，這恰好是筆記的核心需求。

Markdown 筆記語法速查

下面這些是用 Markdown 記筆記時最常用的語法，按使用頻率排列。如果你想系統地學習每種語法，可以點擊對應連結查看詳細教學。

標題——筆記的骨架

用 # 號表示標題層級，一級標題一個 #，二級兩個，以此類推：

# 會議記錄（一級標題）
## 專案進展（二級標題）
### 前端開發（三級標題）

我個人習慣在筆記中最多用到三級標題。層級太深反而會讓筆記變得難以瀏覽。關於標題語法的更多細節，可以參考 Markdown 標題語法詳解。

文字強調——劃重點

**重要內容用加粗**
*輕微強調用斜體*
~~過時的資訊用刪除線~~

記筆記時，加粗是最常用的強調方式，我一般用它來標註關鍵概念和待辦事項的核心內容。斜體適合用來標註英文術語或次要強調。想瞭解更多可以看 Markdown 加粗語法和 Markdown 斜體語法。

列表——整理思路

無序列表用 - 或 *：

- 今天的學習目標
  - 完成 CSS 佈局章節
  - 練習 Flexbox 案例
- 明天的計畫

有序列表用數字：

1. 第一步：確定筆記主題
2. 第二步：列出關鍵要點
3. 第三步：補充細節和例子

列表是筆記中最頻繁出現的元素，沒有之一。想深入瞭解列表巢狀、縮排等技巧，可以看 Markdown 列表語法詳解。

任務列表——待辦事項

- [x] 整理本週學習筆記
- [ ] 複習 JavaScript 閉包
- [ ] 寫專案週報

這個語法在 GitHub Flavored Markdown（GFM）中支援，大部分筆記軟體也支援。打勾的感覺是真的會上癮。

引用——摘錄和批註

> 好記性不如爛筆頭，爛筆頭不如好方法。

引用區塊（blockquote）特別適合在筆記中摘錄原文或新增自己的批註。在 Markdown 引用語法中有更多用法。

程式碼區塊——技術筆記必備

行內程式碼用反引號：console.log('hello')

程式碼區塊用三個反引號：

```javascript
function greet(name) {
  return `Hello, ${name}!`;
}


如果你經常記技術筆記，程式碼區塊是使用頻率最高的語法之一。詳細用法參考 [Markdown 程式碼區塊語法](/markdown/code-block/)。

### 連結和圖片——關聯資源

```markdown
[筆記原文](https://example.com/article)

![截圖說明](screenshot.png)

在筆記中引用外部資料或插入截圖時，Markdown 連結和 Markdown 圖片語法非常方便。

表格——結構化資訊

| 軟體 | 平台 | 價格 | Markdown 支援 |
|------|------|------|--------------|
| Obsidian | 全平台 | 免費 | 原生支援 |
| 有道雲筆記 | 全平台 | 免費/會員 | 支援 |
| Evernote | 全平台 | 免費/付費 | 支援 |

更多表格技巧（對齊方式、複雜表格）可以看 Markdown 表格語法詳解。

分割線——內容分隔

---

上面的內容講完了，下面開始新的話題。

三個短橫線就是一條分割線，用來區分筆記的不同部分。

Markdown 筆記模板（拿來就用）

說實話，模板這東西每個人的習慣不一樣，但有幾個通用模板我用了好幾年，分享出來你可以直接複製改改用。

模板一：會議記錄

# 會議記錄：{專案名稱}週例會

**日期：** 2026-05-04
**參會人：** Alice、Bob、Carol
**記錄人：** 我

## 議題

### 1. 上週進展

- 前端頁面完成 80%，剩餘表單驗證部分
- 後端介面已全部聯調通過

### 2. 本週計畫

- [ ] 完成表單驗證和錯誤提示
- [ ] 行動端適配
- [ ] 效能最佳化——首屏載入時間目標 < 2s

### 3. 待確認事項

- 設計稿中彈窗樣式需要和 UI 確認
- 第三方支付介面文件還沒收到

## 下次會議

**時間：** 2026-05-11 10:00
**議題：** Sprint 回顧 + 下階段規劃

模板二：學習筆記

# {課程/書籍名稱}學習筆記

**標籤：** #前端 #CSS
**日期：** 2026-05-04

## 核心概念

**Flexbox** 是一種一維佈局模型，可以沿著主軸或交叉軸排列元素。

### 關鍵屬性

| 屬性 | 作用 | 常用值 |
|------|------|--------|
| display | 啟用彈性佈局 | flex |
| flex-direction | 主軸方向 | row, column |
| justify-content | 主軸對齊 | center, space-between |
| align-items | 交叉軸對齊 | center, stretch |

## 我的理解

Flexbox 解決的核心問題是：讓容器中的元素能夠靈活地分配空間和對齊。以前用 float 佈局需要各種清除浮動、計算寬度，現在幾行 CSS 就搞定。

## 實踐練習

```css
.container {
  display: flex;
  justify-content: space-between;
  align-items: center;
}

疑問與待查

[ ] flex-basis 和 width 的優先級關係是什麼？
[ ] 巢狀 flex 容器的效能影響有多大？

參考資料

MDN Flexbox 指南

模板三：技術方案筆記

# 技術方案：{功能名稱}

**作者：** 我
**日期：** 2026-05-04
**狀態：** 草案

## 背景

目前系統在處理大批量資料匯出時，介面回應時間超過 30 秒，使用者頻繁逾時。

## 方案對比

| 方案 | 優點 | 缺點 | 複雜度 |
|------|------|------|--------|
| 非同步匯出 + 郵件通知 | 使用者體驗好 | 需要訊息佇列 | 中 |
| 分頁載入 + 前端快取 | 實現簡單 | 資料量大時卡頓 | 低 |
| WebSocket 推送進度 | 即時回饋 | 需要長連線 | 高 |

## 最終方案

採用非同步匯出方案，具體實現：

1. 前端發起匯出請求，後端回傳任務 ID
2. 後端將任務放入佇列，非同步處理
3. 處理完成後傳送郵件通知，附帶下載連結

## 注意事項

- 單次匯出上限設為 10 萬條
- 檔案保留 7 天後自動清理
- 失敗重試最多 3 次

模板四：日常待辦

# 今日待辦 — 2026-05-04

## 緊急且重要

- [ ] 修復線上支付回呼逾時問題
- [ ] 回覆客戶的技術諮詢郵件

## 重要不緊急

- [ ] 整理上週的技術分享 PPT
- [ ] 學習 Docker Compose 基礎

## 雜項

- [ ] 預約週五的會議室
- [ ] 更新專案文件中的介面說明

## 今日總結

完成了支付回呼問題的排查，根因是第三方介面逾時時間設定過短（5s），調整為 15s 後解決。這個經驗值得記錄：**對接第三方介面時，逾時設定要留足餘量。**

Markdown 筆記軟體推薦

選對工具，用 Markdown 記筆記的體驗會好很多。下面是我實際用過的一些軟體，按場景分類。

主流 Markdown 筆記軟體對比

軟體	平台	價格	核心特點	適合誰
Obsidian	Win/Mac/Linux/行動端	免費（同步付費）	本機儲存、雙向連結、外掛生態豐富	知識管理重度使用者
有道雲筆記	Win/Mac/行動端	免費/會員	國內老牌、雲端同步、支援 Markdown	國內使用者、輕量需求
Evernote	Win/Mac/行動端	免費/付費	網頁剪藏強、多端同步	資訊收集型使用者
Notion	Web/Win/Mac/行動端	免費/付費	資料庫功能強、協作方便	團隊協作、專案管理
VS Code	Win/Mac/Linux	免費	外掛豐富、終端整合	程式設計師、技術筆記
Bear	Mac/iOS	免費/訂閱	介面美觀、標籤管理	Apple 生態使用者

資料來源：各軟體官方網站，2026 年 5 月查詢。價格可能隨時間變化，請以官網為準。

我的選擇建議

如果你是剛開始用 Markdown 記筆記，我的建議是先用有道雲筆記或 Evernote，門檻低，打開就能寫。等你覺得「我想要更多控制權和定製空間」的時候，再考慮切換到 Obsidian。

如果你是程式設計師，VS Code 裝個 Markdown 預覽外掛（推薦 Markdown Preview Enhanced）就夠了，反正你每天都在用，不用額外裝軟體。

Markdown 筆記的進階技巧

掌握基本語法之後，這些技巧能讓你的筆記品質再上一個台階。

用標籤系統組織筆記

在筆記開頭加上標籤，方便後續檢索：

---
tags: [前端, CSS, 佈局]
date: 2026-05-04
---

# Flexbox 學習筆記
...

這種寫法叫做 front matter，Obsidian、Hugo 等工具都能自動識別。很多筆記軟體會根據這些標籤自動歸類。

用腳註新增參考資料

寫學習筆記時，腳註比直接塞連結更整潔：

CSS Grid 是二維佈局系統[^1]，和 Flexbox 的一維佈局互補[^2]。

[^1]: MDN CSS Grid 指南: https://developer.mozilla.org/zh-TW/docs/Web/CSS/CSS_grid_layout
[^2]: CSS-Tricks Flexbox 指南: https://css-tricks.com/snippets/css/a-guide-to-flexbox/

腳註的詳細語法可以參考 Markdown 腳註教學。

數學公式——學術筆記利器

如果你的筆記涉及數學（比如統計、物理、經濟學），大部分 Markdown 筆記軟體都支援 LaTeX 公式：

行內公式：$E = mc^2$

區塊公式：
$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$

這在有道雲筆記、Obsidian、VS Code 中都能正常渲染。更多語法細節參考 Markdown 數學公式教學。

Mermaid 圖表——一張圖勝千言

有些筆記用文字描述很囉嗦，畫個流程圖就清楚了。Mermaid 語法可以直接在 Markdown 中嵌入圖表：

```mermaid
graph TD
    A[開始] --> B{是否理解？}
    B -->|是| C[記入筆記]
    B -->|否| D[查資料]
    D --> E[理解後記入筆記]
    E --> C
    C --> F[定期複習]



Obsidian、GitHub、有道雲筆記都支援 Mermaid 渲染。

## 避開這些常見問題

用 Markdown 記筆記的路上有幾個小坑，提前知道能省不少時間。

### 換行不是按回車

在 Markdown 中，單獨一個回車不會產生新段落。你需要**在行末加兩個空格**再回車，或者**空一行**來分段。這個細節坑了我很久，後來養成了空行分段的習慣就好了。詳細說明看 [Markdown 換行語法](/markdown/new-line/)。

### 特殊字元需要轉義

如果你的筆記內容中包含 `*`、`_`、`#` 這些 Markdown 語法符號，但不想它們被解析為格式，用反斜線轉義：`\*這不是斜體\*`。更多轉義規則參考 [Markdown 轉義字元](/markdown/escape/)。

### 不同軟體的語法差異

我遇到過一個讓人頭痛的事：同一篇筆記在 Obsidian 裡渲染正常，換到 GitHub 上就出問題。原因是不同 Markdown 解析器對語法的支援不完全一致。常見的差異有：

| 語法元素 | 標準 Markdown | GFM (GitHub) | Obsidian |
|----------|--------------|--------------|----------|
| 任務列表 | 不支援 | 支援 | 支援 |
| 腳註 | 不支援 | 支援 | 支援 |
| 數學公式 | 不支援 | 不支援 | 支援 |
| 雙向連結 | 不支援 | 不支援 | 支援 |
| 表格 | 不支援 | 支援 | 支援 |

> 資料來源：[Markdown Guide](https://www.markdownguide.org/extended-syntax/) 和各工具官方文件，2026 年 5 月整理。

所以我的習慣是：**如果你主要在一個軟體裡用，就按那個軟體的語法來。如果需要跨平台，儘量只用標準 Markdown 語法**（標題、列表、加粗、連結、程式碼區塊）。

## 我的 Markdown 筆記習慣

分享幾個我堅持了多年的小習慣，確實有效：

**一是每篇筆記都寫日期。** 放在標題或開頭，方便日後按時間線回顧。我用的格式是 `YYYY-MM-DD`，排序天然有序。

**二是標題層級不超過三級。** `#` 是筆記標題，`##` 是大板塊，`###` 是具體內容。再深了就說明這篇筆記應該拆成幾篇。

**三是定期整理。** 每週末花 20 分鐘，把本週的零散筆記歸檔到對應的主題資料夾裡。不整理的筆記和沒記一樣。

**四是善用搜尋。** 筆記多了之後，與其花時間設計複雜的目錄結構，不如依賴全文搜尋。Markdown 是純文字，搜尋速度極快，一個關鍵字就能找到相關內容。

## 小結

Markdown 記筆記這件事，說到底就三步：學會幾個常用符號、找個順手的軟體、養成持續記錄的習慣。語法本身沒幾行，但用好它記筆記的效率提升是實打實的。

如果你還沒開始，打開任何一個文字編輯器，複製上面的模板，從今天的筆記開始寫吧。

---

**參考資料：**

- [Markdown Guide — Basic Syntax](https://www.markdownguide.org/basic-syntax/)：最權威的 Markdown 語法參考
- [GitHub Docs — Basic Writing and Formatting Syntax](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)：GitHub 官方 Markdown 文件