LOVEMarkdown

什麼是 Markdown？新手入門完全攻略

The LoveMarkdown TeamPublished

簡單來說，Markdown 是一套讓你用純文字就能排版的語法。2004 年由 John Gruber 提出，初衷很單純：希望文件在「沒有渲染」的狀態下依然好讀。你不需要碰 HTML 那些繁瑣的標記，只要用 # 就能標標題、用 **粗體** 就能加粗，乾淨又直覺。

到了今天，Markdown 幾乎無處不在。工程師、技術寫手、學生、部落客都在用，GitHub、Reddit、Stack Overflow、Discord、Slack 這些平台更是全面支援。

.md 檔案是什麼？

.md 檔案就是一個「寫了 Markdown 語法的純文字檔」。副檔名取自 Markdown 的縮寫，偶爾也會看到 .markdown，但絕大多數人都用 .md。

因為它本質上就是純文字，所以任何文字編輯器都能開啟 — 記事本、TextEdit、VS Code 都行，甚至瀏覽器也沒問題。想要看到排版效果的話，就必須用支援 Markdown 的應用程式來瀏覽。

Markdown 為什麼會誕生？

John Gruber 的設計理念只有一個重點：原始內容要能直接閱讀。HTML 或 LaTeX 的原始碼很難直接看，但 Markdown 不一樣，即使不經過任何轉譯，你也能輕鬆讀懂內容。來看個例子：

## 寫 HTML
<h2>我的標題</h2>
<p>這是<strong>粗體</strong>的文字。</p>

## 寫 Markdown
## 我的標題
這是**粗體**的文字。

最後產出的結果一模一樣，但 Markdown 的原始碼顯然好讀多了。

哪些人在用 Markdown？

  • 工程師 — README、技術文件、程式碼註解
  • 技術寫手 — API 文件、操作手冊、Wiki
  • 部落客 — 在 Ghost、WordPress、Jekyll 上寫文章
  • 學生 — 筆記、報告、簡報素材
  • 資料科學家 — Jupyter Notebook、R Markdown 報告
  • 專案管理 — GitHub/GitLab Issue、Confluence 頁面

Markdown 用在哪些地方？

幾乎所有主流平台都支援 Markdown，以下列幾個常見的：

  • GitHub / GitLab — README、Issue、Pull Request、Wiki
  • Stack Overflow — 問題和回答的排版
  • Reddit — 留言格式
  • Discord / Slack — 訊息排版
  • Notion / Obsidian / Bear — 筆記工具
  • Ghost / Jekyll / Hugo — 靜態網站和部落格
  • VS Code / Atom — 文件撰寫和即時預覽

基本語法快速上手

以下是最常用的幾個 Markdown 元素：

標題

# 一級標題
## 二級標題
### 三級標題

粗體與斜體

**粗體**
*斜體*
***粗體加斜體***

清單

- 項目一
- 項目二

1. 第一項
2. 第二項

連結與圖片

[連結文字](https://example.com)
![圖片說明](image.png)

程式碼

行內 `code` 用反引號包起來。

```javascript
// 程式碼區塊，支援語法高亮
console.log("Hello, Markdown!");
```

引用與表格

> 這是一段引用。

| 欄位一 | 欄位二 |
|--------|--------|
| 資料一 | 資料二 |

更完整的語法整理，可以參考Markdown 速查表。

Markdown 的各種「口味」

原版 Markdown 之外，還有一些常見的擴展版本：

  • CommonMark — 把 Markdown 規格標準化，消除語法的模糊地帶
  • GitHub Flavored Markdown (GFM) — 加入表格、任務清單、刪除線、語法高亮等功能
  • Markdown Extra — 支援腳註、定義清單、縮寫
  • R Markdown — 可以直接跑 R 程式碼，資料分析必備
  • MultiMarkdown — 額外支援表格、腳註、metadata

現在大部分的工具都支援 GFM 或 CommonMark，日常使用幾乎沒有問題。

怎麼開始用 Markdown？

  1. 打開你慣用的文字編輯器 — VS Code、記事本、TextEdit，或線上編輯器都行
  2. 開始寫 — 用 Markdown 語法排版
  3. 存成 .md 檔 — 搞定，一份 Markdown 文件就完成了
  4. 預覽或轉檔 — 用 Markdown 檢視器看效果，或轉成 PDF、HTML、Word

把 Markdown 轉成其他格式

Markdown 最方便的地方之一，就是轉檔非常容易。一份 .md 檔可以輕鬆變成：

常見問題

Markdown 跟 HTML 一樣嗎？

不一樣，Markdown 簡單太多了。Markdown 用 **粗體**，HTML 要寫 <strong>粗體</strong>。Markdown 重視的是「好讀好寫」，HTML 則是為了網頁結構而設計。當然，如果需要的話，你可以在 Markdown 裡面混用 HTML。

Markdown 可以拿來寫正式文件嗎？

當然可以。很多公司（GitHub、Stripe、Twilio）的官方文件都是用 Markdown 寫的。寫完之後轉成 PDF 或 Word，就是一份很專業的成品了。

Markdown 要錢嗎？

完全免費，而且開源。語法本身不用錢，市面上也有超多免費的編輯器和工具可以選。

.md 跟 .txt 有什麼差？

兩個都是純文字檔，差別在於 .md 有 Markdown 排版語法。用支援 Markdown 的編輯器打開 .md 會看到排版後的樣子，用一般的純文字編輯器打開則會看到原始的語法。