作家 Markdown 指南
Markdown 是 GitHub、Reddit、Discord、Notion、Obsidian、Substack、Ghost 和無數靜態網站產生器背後的輕量級標記語言。這是您可以添加書籤的備忘單，還有兩個免費轉換器。
如果您在線上寫作並且不瞭解 Markdown，那麼您花在格式化上的時間比寫作的時間還要多。 Markdown 允許您使用約 6 個簡單符號表達標題、粗體、斜體、列表、鏈接、代碼、塊引用和圖像 — 沒有菜單、沒有工具欄、沒有鼠標。它也是每個值得使用的現代書寫工具之間的通用導出/導入格式。
本指南是語法備忘單、何時使用什麼建議以及我們為處理 Markdown 和 HTML 之間的遷移而構建的兩個免費轉換器的連結。
文法備忘錄
標題
# H1 (one per page — your title)
## H2 (main sections)
### H3 (subsections)
#### H4
##### H5
###### H6 (rarely needed)一 # 每個標題等級。哈希值和標題文字之間有一個空格。不要在文章中使用 H1 — Markdown CMS 已經使用貼文標題作為 H1。
粗體和斜體
**bold**
*italic*
***bold and italic***
~~strikethrough~~ (GitHub-flavored only)使用 ** 大膽地結束 __ — 它更易讀並且適用於各種風格。使用 * 斜體結束 _ 出於同樣的原因。
連結和圖像
[Visible link text](https://example.com)
[Reference-style link][1]
[1]: https://example.com當在長文件中多次使用相同的 URL 時，參考樣式連結（底部形式）非常有用。
清單
- Unordered item
- Another item
- Nested item (2-space indent)
1. Ordered item
2. Second item
1. Nested ordered item專業提示： 對於有序列表，你可以寫 1. 對於每一行——大多數處理器都會自動重新編號。這使得插入/移除物品變得更加容易。
程式碼
`inline code` for a quick keyword
```
multi-line code block
```
```python
fenced code block with language
```三重反引號圍欄區塊受到普遍支持，並允許您指定語法突出顯示的語言。
區塊引用和水平規則
> This is a blockquote.
> Multi-line by repeating > on each line.
--- (three or more dashes = horizontal rule)表格（GitHub 風格的 Markdown）
| Header | Header |
|--------|--------|
| Cell | Cell |
| Cell | Cell |表格不是原始 Markdown 中的，但在現代風格中是通用的（GitHub、Notion、Obsidian、每個靜態網站產生器）。
在 Markdown 和 HTML 之間轉換
大多數 CMS 接受 Markdown 或 HTML，但有些會強制您選擇其中一個。兩種最常見的工作流程：
- 用 Markdown 編寫，需要 HTML 來建立純 HTML CMS？ 使用我們的 Markdown → HTML 轉換器。貼上 Markdown，複製 HTML，放入您的 CMS。
- 將內容從純 HTML CMS 遷移到 Markdown 系統（Notion、Obsidian、GitHub、Hugo）？ 使用我們的 HTML → Markdown 轉換器。去除內聯樣式、類和噪音——留下乾淨的 Markdown。
整個生態系的降價
| 工具 | 降價風味 | 註解 |
|---|---|---|
| GitHub 自述文件/問題 | GitHub 風格的 Markdown (GFM) | 表格、任務列表、自動鏈接 |
| 紅迪網 | CommonMark + 擴充 | 劇透標籤、上標/下標 |
| 不和諧/鬆弛 | 子集 | Bold/italic/code/strikethrough/blockquote |
| 概念 | CommonMark + 資料庫擴展 | 切換塊、標註 |
| 黑曜石 | CommonMark + 維基鏈接 | [[wikilinks]]、嵌入、frontmatter |
| 子堆疊/幽靈 | 通用標誌 | 標準通用標誌 |
| 雨果/傑基爾/十一 | CommonMark + 前言 | YAML frontmatter 位於檔案頂部 |
| iA 作家 / 熊 / 尤利西斯 | 通用標誌 | 所見即所得編輯 |
何時不使用 Markdown
Markdown 非常適合散文和結構。它不適合：
- 視覺/設計為主的內容。 如果您要佈置雜誌頁面，請使用設計工具，而不是 Markdown。
- 表單、調查、複雜表格和樣式內容。 Markdown 無法表達 HTML+CSS 可以表達的內容。如果您需要精確控製字體、顏色、列或互動元素，請直接編寫 HTML。
- 數學符號。 一些處理器在 Markdown 中支援 LaTeX (
$\\alpha$），但支援不一致。對於繁重的數學計算，LaTeX 優先的工具會勝出。 - 高度結構化的資料。 使用 JSON / YAML / TOML，而不是 Markdown 清單。
Frontmatter－秘密武器
大多數靜態站點產生器都支援每個 Markdown 文件頂部的 YAML frontmatter。這是生成器在構建時讀取的有關帖子的元數據 - 標題、日期、標籤、作者。
---
title: My First Blog Post
date: 2026-05-07
author: Jane Smith
tags: [writing, productivity]
---
# My First Blog Post
Body of the post in Markdown…不同的生成器需要不同的密鑰。雨果使用 title, date, draft;傑基爾使用 layout, title, permalink;十一種用途 permalink, tags, layout。請閲讀生成器的文檔以瞭解具體資訊。
本指南中使用的免費工具
- Markdown → HTML 轉換器 — 將 Markdown 轉換為乾淨的語意 HTML。
- HTML → Markdown 轉換器 — 從渲染的 HTML 中提取乾淨的 Markdown，非常適合內容遷移。
- 尋找和替換 — 對於將一種 Markdown 變體批量轉換為另一種非常有用。
- 字數統計器 — 草稿的字數和可讀性分數。
- 字元計數器 — Markdown 文件有硬性限制的次數的字元數（例如 GitHub README 徽章）。
常見問題
Markdown 和 CommonMark 有什麼差別？
GitHub 風味的 Markdown 有何不同？
- [x])、刪除線和自動連結。大多數現代 CMS 遵循 GFM 而不是嚴格的 CommonMark，因此如有疑問，請編寫 GFM。