--- # System prepended metadata title: Markdown 新手完整指南 — 從零到 AI 時代，一篇就搞懂 tags: [教學, markdown, 新手入門, 知識管理, AI] --- --- title: Markdown 新手完整指南 — 從零到 AI 時代，一篇就搞懂 date: 2026-04-20 tags: [markdown, 教學, 新手入門, AI, 知識管理] description: 完全沒接觸過 Markdown？這篇從「是什麼」講到「為什麼連 AI 都愛它」。不用 15 分鐘，你就能寫出第一篇 Markdown 文件。 cover: markdown-主視覺.jpg --- # Markdown 新手完整指南 — 從零到 AI 時代，一篇就搞懂 ![markdown-主視覺](https://hackmd.io/_uploads/ryB09HXa-g.jpg) ## 等一下，這是什麼？為什麼我的朋友都在用？ 有沒有發生過這種事： 你打開朋友傳來的檔案，副檔名是怪怪的 `.md`。用 Word 打開，亂碼；用記事本打開，看到滿滿的 `#`、`**`、`-`，像某種密碼。你關上檔案，心想「這不是我的世界」。 但你後來又發現，GitHub 上每個專案都有個 `README.md`；你用 ChatGPT 或 Claude 問問題，它的回答總是整整齊齊有標題有清單；你朋友的 Obsidian 筆記軟體裡，每個檔案都是 `.md`。 這個神秘的東西叫 **Markdown**。而且老實說，它比你想像的簡單太多了，**真的只要 15 分鐘就能學會**。 這篇文章會帶你從零開始。沒有術語轟炸，每個概念都有例子。讀完之後，你不只會寫 Markdown，還會懂為什麼 2026 年的 AI 工具幾乎全都用它當預設輸出格式。 --- ## Markdown 是什麼？用白話解釋 想像一下，你在紙上寫筆記。你會怎麼標示「這是標題」？ 大部分人會**畫底線**、**寫大一點**，或者**在前面加一個圓點**。這些動作背後有個邏輯：用最小的符號傳達最大的意思。 Markdown 就是把這個邏輯搬到電腦上。它是一種**輕量級標記語言（lightweight markup language）**，由 John Gruber 和 Aaron Swartz 在 [2004 年發明](https://en.wikipedia.org/wiki/Markdown) ，核心哲學就一句話： > 讓純文字看起來就像「已經被格式化過」，而且任何人不需要學習就能看懂。 舉個例子。同一段內容，三種寫法： **HTML 寫法**（網頁用的）： ```html

今天的待辦

``` **Word 檔**：一個你打不開原始碼的二進位檔，只能用特定軟體編輯。 **Markdown 寫法**： ```markdown # 今天的待辦 - 買牛奶 - **打電話給媽媽** ``` 哪個看起來比較舒服？哪個不用軟體就看得懂？ 這就是 Markdown 的魔法。它是「**純文字**」（plain text），意思是你用任何編輯器都能打開，二十年後也不會失效。但它又透過幾個簡單符號（`#`、`*`、`-`）加上了「結構感」，可以被轉換成漂亮的網頁、PDF、甚至投影片。 --- ## 為什麼要學？Word 不好嗎？ ![markdown-vs-word](https://hackmd.io/_uploads/B1VT6rQ6Zg.jpg) 我知道你在想什麼：「我已經會用 Word 了，為什麼要學新東西？」 這是個好問題。讓我直接給你三個 Word 解決不了、但 Markdown 輕鬆搞定的場景。 ### 場景一：半年後，你打不開自己的檔案 你有沒有過這種經驗：打開三年前的 Word 檔，排版全亂掉？或者用新版 Word 開舊檔，字型跑位？ Word 的檔案格式（`.docx`）是**二進位格式**，需要特定軟體（通常還要付費）才能解讀。軟體升級、格式改變，舊檔就可能出事。 Markdown 是**純文字**，底層用的是 UTF-8 編碼，**向後相容到 1963 年的 ASCII**。你現在寫的 `.md` 檔案，20 年後用任何一個文字編輯器都還是打得開。 ### 場景二：`final_v3_真的_ACTUAL_FINAL.docx` 你一定看過這種檔名吧。 Word 檔案因為是二進位格式，**沒辦法用 Git 做版本控制**。每次改動都是「整個檔案變了」，你無法看到「我昨天改了哪一句話」。 Markdown 是純文字，完美契合 Git。我改了一個字、加了一行、刪了一個段落，Git 都能精準顯示。[ModernActuary 的技術部落格](https://modernactuary.co.za/journal/version-controlling-docx) 有篇文章講得很好：「用 Markdown + Git，你永遠會有一個明確的最新版本，每次改動都有紀錄，誰改的、什麼時候改的、為什麼改，都一清二楚。」 ### 場景三：你想要的，Word 永遠給不了的自由 Word 有個本質問題：**內容和樣式綁在一起**。你在 Word 裡寫的東西，離開 Word 就變形。 Markdown 反過來 — **內容是內容，樣式是樣式，完全分離**。同一份 `.md` 檔案，你可以透過工具變成： - 網頁（HTML） - PDF 文件 - Word 檔（需要給不會用 Markdown 的人） - 投影片（reveal.js） - 電子書（ePub） - 靜態網站（Jekyll、Hugo、Hexo） 一份來源，多種產出。這就是專業寫作者、工程師、研究者越來越愛用 Markdown 的原因。[哈佛學者 Stuart Shieber 甚至寫過一篇專文](http://blogs.law.harvard.edu/pamphlet/files/2014/08/markdownpost-acmsmall.pdf) ，直接叫「為什麼學者應該用 Markdown 寫論文」。 --- ## 10 分鐘學會：Markdown 基本語法 好，夠多理論了。來動手吧。 你現在只需要一個地方「寫東西」。最快的方法：打開瀏覽器，到 [stackedit.io](https://stackedit.io/) 或 [dillinger.io](https://dillinger.io/) ，左邊打字，右邊即時看到結果。 準備好了嗎？接下來是你這輩子唯一需要的 Markdown 速查表。 ### 標題：用 `#` 的數量決定大小 ```markdown # 這是最大的標題（H1） ## 第二大標題（H2） ### 第三大標題（H3） #### 第四大標題 ##### 第五大標題 ###### 最小的標題 ``` **新手第一個坑**：`#` 後面**一定要有空格**。寫 `#標題` 不會變成標題，寫 `# 標題` 才會。 ### 粗體、斜體、刪除線 ```markdown 這是 **粗體** 這是 *斜體* 這是 ***粗斜體*** 這是 ~~刪除線~~ ``` 記憶法：一顆星是斜體，兩顆星是粗體。就像喊話：「特別一點！」用一層，「超級重要！」用兩層。 ### 清單：購物清單 or 流程步驟 無序清單（項目沒先後）： ```markdown - 蘋果 - 香蕉 - 牛奶 - 低脂 - 全脂 ``` 有序清單（有先後順序）： ```markdown 1. 起床 2. 刷牙 3. 發現手機沒電 4. 充電再睡回去 ``` **小技巧**：有序清單你全部寫 `1.` 也沒關係，Markdown 會自動幫你編號。這讓你之後插入新項目時不用重新排。 待辦清單（大家最愛）： ```markdown - [ ] 買牛奶 - [x] 打電話給媽媽 - [ ] 寫週報 ``` ### 連結和圖片 兩個語法長得很像，只差一個驚嘆號： ```markdown 連結：[顯示的文字](https://網址.com) 圖片：![替代文字](圖片網址或路徑.jpg) ``` 例子： ```markdown 我每天必看 [Hacker News](https://news.ycombinator.com)。 ![我家的貓](./cat.jpg) ``` ### 程式碼：單行和多行 行內程式碼（一個反引號）： ```markdown 要安裝請執行 `npm install` ``` 多行程式碼區塊（三個反引號，可以指定語言讓它有語法高亮）： ````markdown ```python def hello(): print("Hello, Markdown!") ``` ```` ### 引用：擷取別人說的話 ```markdown > 純文字是所有格式的起點和終點。 > — Wired 雜誌，論 Markdown ``` ### 表格：簡單資料整理 ```markdown | 工具 | 價格 | 適合誰 | | --- | --- | --- | | Obsidian | 免費（個人）| 重度知識管理 | | HackMD | 免費起步 | 團隊協作 | | VSCode | 免費 | 開發者 | ``` **坑預警**：表格的語法稍微囉嗦，但大多數編輯器（Obsidian、Typora）都有表格快捷鍵，不需要手打。 ### 分隔線 三個減號、星號或底線都可以： ```markdown --- ``` ### HTML 備案：當 Markdown 不夠用時 這招很少新手知道：**Markdown 可以混寫 HTML**。比如你要讓圖片置中、改變尺寸： ```markdown ``` 完全合法。Markdown 不是一個封閉系統，它和 HTML 和諧共處。 --- ## 新手最常踩的 5 個坑 寫了幾年 Markdown，我見過太多人卡在同樣的地方。先把這些記下來，省你幾小時的鬱悶時間。 **第一坑：`#` 後面忘記加空格** `#標題` ❌ 不會變標題 `# 標題` ✅ 正確 **第二坑：換行不換行** 你在 Markdown 裡按一次 Enter，有些渲染器會當作「同一個段落」，不換行。想要真正換行，**按兩次 Enter**（留一個空白行）。 **第三坑：清單項目間不要亂空行** ```markdown - 項目一 - 項目二 ``` 中間空行，有些編輯器會視為兩個獨立清單。除非你要故意分開，不然連續寫就好。 **第四坑：表格對齊要用冒號** ```markdown | 左對齊 | 置中 | 右對齊 | | :--- | :---: | ---: | ``` 分隔列的冒號位置決定對齊方向。 **第五坑：Obsidian、GitHub、HackMD 的語法有細微差異** 這是 Markdown 生態最大的缺點：各家有各家的「flavor（口味）」。最常見的是 GitHub Flavored Markdown (GFM)，支援表格、待辦清單、程式碼語法高亮等。遇到特殊功能不相容時，不要慌，那是正常的。想了解標準化努力，可以看 [CommonMark](https://commonmark.org/) 這個專案。 --- ## 工具推薦：我該用哪一個？ ![markdown-工具推薦](https://hackmd.io/_uploads/HyX1AH7T-l.jpg) 市面上的 Markdown 編輯器多到你眼花。我幫你整理成四類場景，直接對號入座。 ### 場景一：我要做個人知識管理（第二大腦） **首選：[Obsidian](https://obsidian.md/)** - **免費**（個人使用） - 所有筆記是本機 `.md` 檔，**你完全擁有資料** - 強大的雙向連結（`[[筆記名]]`）打造知識網絡 - 1000+ 社群外掛 - 內建 AI 整合越來越強，2026 年成為「第二大腦」的主流選擇 我自己就是重度 Obsidian 使用者。推薦理由：20 年後這些 `.md` 檔你都還打得開，Obsidian 倒了也沒差。 ### 場景二：我要和團隊即時協作 **首選：[HackMD](https://hackmd.io/)** - 雲端即時協作，像 Google Docs 但是 Markdown 版 - 會議筆記、團隊文件、技術分享的神器 - 可以直接發布成簡報（reveal.js） - 免費帳號就很夠用 ### 場景三：我是寫程式的 **首選：[VSCode](https://code.visualstudio.com/) + Markdown 外掛** - 原生支援 Markdown 預覽（`Ctrl/Cmd + Shift + V`） - 裝 Markdown All in One 外掛後體驗大升級 - 可以同時管理程式碼和文件 ### 場景四：我只想要一個乾淨的寫作環境 **首選：[Typora](https://typora.io/)**（付費，一次買斷） - 所見即所得（WYSIWYG）的 Markdown 編輯器 - 你打 `**粗體**` 它會直接顯示成粗體，符號自動隱藏 - 適合討厭看到「原始語法」的人 **備用：StackEdit、Dillinger**（網頁版，免費，不用安裝） --- ## 為什麼 2026 年，連 AI 都愛 Markdown？ ![markdown-AI第二大腦](https://hackmd.io/_uploads/r1nCaBXp-x.jpg) 這是這篇文章最有意思的部分。 如果你觀察 ChatGPT、Claude、Gemini 的回答，會發現它們**預設都用 Markdown 格式輸出**。這不是巧合，是一個根本性的技術選擇。 ### 原因一：Token 經濟學 — Markdown 比 HTML 省 40-80% LLM（大型語言模型）以 token 計費。token 簡單講就是「字的小單位」。格式化符號越多，花的 token 越多。 同樣一段有結構的內容，[Cloudflare 實測](https://blog.cloudflare.com/introducing-markdown-for-agents/) 從 HTML 轉成 Markdown，**token 從 16,180 降到 3,150，省了 80%**。有些複雜頁面甚至可以省 95%。 對 AI 公司來說，這是真金白銀的成本差異。 ### 原因二：訓練資料 — LLM 早就「吃」了幾十億份 Markdown GitHub 上幾乎每個 repo 都有 `README.md`。React、Kubernetes、Python 的文件站幾乎都是 Markdown 寫的。Stack Overflow、Reddit 的格式底層也是 Markdown。 **結論**：LLM 在訓練時讀了數十億份 Markdown 文件。對它來說，輸出 Markdown 就像「回到母語」。 ### 原因三：「Markdown is the new API」 這是 2026 年最熱的軟體架構趨勢。 根據 [The New Stack 的一篇分析](https://thenewstack.io/skills-vs-mcp-agent-architecture/) ，創投家 Brad Feld 用 **12 個 Markdown 檔案（叫做 CompanyOS）** 經營整間公司 — 每個檔案教 Claude Code 怎麼處理特定任務（寫郵件、客服、準備董事會資料）。沒有複雜的後端系統，就是 `.md` 檔 + Git。 更驚人的數字對比： - GitHub 官方的 MCP 伺服器：教 AI 怎麼用 GitHub，要花 **50,000 個 token** - 一份 `SKILL.md` 檔：寫「用 gh CLI 執行這些操作」，只要 **200 個 token** **相同效果，250 倍效率**。這就是為什麼越來越多開發者相信：**未來的 AI 指令、工作流、公司流程，都會以 Markdown 為載體**。 ### 原因四：你的筆記 = AI 的脈絡 2025 到 2026 年，有個新的工作流在知識工作者之間爆紅： **把 Obsidian vault 當作 AI 的「持久記憶」** 你平常用 Obsidian 記筆記（純 Markdown 檔）。需要 AI 幫忙時，不用每次重新解釋你的背景、專案、偏好 — AI 直接讀你的 vault，知道你是誰、在做什麼。 這個架構叫 **Claude Code + MCP-Obsidian**，相關工具如 [smithery-ai/mcp-obsidian](https://github.com/smithery-ai/mcp-servers) 在 GitHub 上星星數量快速成長。[筆記 app 市場規模預計從 2023 年的 5.76 億成長到 2032 年的 22.6 億美元](https://latenode.com) ，年複合成長率 16.4%。 **一句話總結**：你用 Word 寫的東西，AI 看不懂。你用 Markdown 寫的東西，AI 天生就懂。 --- ## 新手常見問題 FAQ **Q1：我的 `.md` 檔要用什麼打開？** 任何文字編輯器都可以（記事本、VSCode、Sublime Text）。但要看「渲染後」的樣子，用 Obsidian、Typora、VSCode（`Cmd+Shift+V` 預覽）、或網頁版 StackEdit。 **Q2：Markdown 有辦法打出數學公式嗎？** 可以，用 LaTeX 語法包在 `$...$`（行內）或 `$$...$$`（區塊）。但需要支援的渲染器（Obsidian、HackMD、GitHub Issues 等）。 **Q3：我寫好的 Markdown 要怎麼變成 Word 檔給長輩看？** 推薦工具 [Pandoc](https://pandoc.org/) 。安裝後執行： ```bash pandoc input.md -o output.docx ``` 一鍵轉 Word、PDF、ePub 都行。 **Q4：能不能同時用 Markdown 和 Word？** 完全可以。很多專業寫作者的工作流是： 1. 用 Markdown 寫初稿（Obsidian 或 Typora） 2. 用 Pandoc 轉 Word 給編輯或客戶 3. 客戶用 Word track changes 回饋 4. 手動把修改合回 Markdown（或直接接受 Word 版成品） **Q5：Markdown 能做複雜排版（多欄、頁碼、目錄）嗎？** 基本的可以（目錄、腳註），複雜的不行。如果需要精準排版，建議用 LaTeX 或 Typst。但老實說，90% 的人一輩子不會需要這些。 **Q6：手機上能寫 Markdown 嗎？** 可以。Obsidian 有 iOS / Android app，1Writer、iA Writer 也都很棒。 **Q7：Markdown 會不會過時？** [Wired 雜誌的這篇文章](https://www.wired.com/story/the-eternal-truth-of-markdown/) 標題叫「The Eternal Truth of Markdown」（Markdown 的永恆真理）。純文字從 1960 年代活到現在還沒死，Markdown 又站在 AI 浪潮最前線 — 短期內不用擔心這個問題。 --- ## 結語：你的下一步 如果你讀到這裡，恭喜你 — 你已經知道 Markdown 的 80%。剩下的 20%，你會在實際使用中自然學會。 我給你一個具體的 30 天行動建議： **第 1 週**：下載 Obsidian，用 Markdown 寫今天的日記。堅持 7 天。 **第 2 週**：把你腦中某個主題（興趣、工作筆記、學習紀錄）的內容用 Markdown 整理成幾個檔案。嘗試用 `[[雙向連結]]` 串起來。 **第 3 週**：開始在工作場合用 Markdown。跟團隊分享會議紀錄（HackMD）、給主管的週報（轉成 Word 給他）。 **第 4 週**：嘗試把你的 Markdown 筆記接上 AI。讓 Claude 或 ChatGPT 讀你的筆記，回答你的問題。感受那種「AI 理解你的脈絡」的震撼。 一個月後，你會忍不住跟朋友說：「**我以前怎麼會用 Word 用這麼久？**」 祝你寫作愉快。歡迎加入純文字的世界。 --- ## 延伸閱讀 - [Markdown Guide 官方教學](https://www.markdownguide.org/) ：最完整的英文速查 - [CommonMark 標準規範](https://commonmark.org/) ：想搞懂「正統 Markdown」必讀 - [Obsidian 官方說明](https://help.obsidian.md/) ：第二大腦的起點 - [HackMD 使用手冊](https://hackmd.io/c/tutorials) ：團隊協作利器 - [Pandoc 官方文件](https://pandoc.org/) ：格式轉換之王 - [Why scholars should write in Markdown（Stuart Shieber）](http://blogs.law.harvard.edu/pamphlet/files/2014/08/markdownpost-acmsmall.pdf) ：學者視角的深度思考 - [The Eternal Truth of Markdown（Wired）](https://www.wired.com/story/the-eternal-truth-of-markdown/) ：為什麼純文字是永恆的 - [Skills vs MCP Agent Architecture（The New Stack）](https://thenewstack.io/skills-vs-mcp-agent-architecture/) ：AI 時代 Markdown 的新角色 - [Markdown for Agents（Cloudflare）](https://blog.cloudflare.com/introducing-markdown-for-agents/) ：網站為 AI 提供 Markdown 的未來 --- *這篇文章是我在 2026 年 4 月，研究後寫成的。所有數據、工具版本、趨勢觀察皆為當時最新資訊。如果你是五年後才看到這篇文章，歡迎告訴我哪些地方已經過時 — 但我打賭，核心概念還是適用的。畢竟，Markdown 活了 22 年了。*