用純文字,寫出結構化的文件 — What & Why
Markdown 是一種「以純文字撰寫、渲染成結構化文件」的輕量標記語言(lightweight markup language)。 你用一般打字的方式輸入符號與文字,再用任何一款 Markdown 編輯器或渲染器,就能把同一份文字變成帶有 標題、清單、表格、程式碼區塊的美觀文件。
# 這是標題 **這是粗體**,*這是斜體*。
這是粗體,這是斜體。
2004 年,John Gruber 與 Aaron Swartz 提出 Markdown,
靈感來自當時程式設計師在電子郵件裡用符號排版(例如用 *星號* 表示粗體)的習慣。
目標很明確:
原文定義:「Markdown is intended to be as easy-to-read and easy-to-write as is feasible.」
三者的定位不同,用一張表比較:
| 比較 | Markdown | HTML | Word(.docx) |
|---|---|---|---|
| 本質 | 輕量標記語言 | 全功能標記語言 | 二進位文件格式 |
| 學習成本 | 低(10 種語法) | 中高(標籤多) | 中(需滑鼠操作) |
| 原始檔可讀性 | 極高 | 低(被標籤淹沒) | 不可讀(二進位) |
| 版本控管(Git) | 理想(純文字 diff) | 可行 | 困難(binary diff) |
| 典型用途 | 文件、README、筆記 | 網頁 | 正式報告、排版稿 |
你不必刻意「找地方用」,現代開發者日常已經離不開它:
| 場域 | 用途 | 單元 |
|---|---|---|
| GitHub | README、Issue、Pull Request 描述 | 單元 6 |
| 筆記軟體 | Obsidian、Logseq、Notion 的底層格式 | 單元 7 |
| 靜態網站 | Hugo、Astro、mkdocs 的文章原始檔 | 單元 7 |
| 文件系統 | Wiki、部落格、API 文件 | 單元 7 |
| AI 工具 | AI 輸出文件的預設格式 | — |
不需要安裝任何東西,三種方式任選:
.md 檔即可預覽。