Markdown 語法指南：從入門到進階

Markdown 是開發者真正樂於使用的寫作格式。不需要在格式選單中來回點擊，不需要和所見即所得編輯器搏鬥——只需要純文字加上幾個符號就能轉換成乾淨的 HTML。README 檔案、技術文件、部落格文章、聊天訊息，甚至這篇文章本身都是用 Markdown 撰寫的。

使用我們的 Markdown 預覽工具即時預覽你的 Markdown——一邊撰寫，一邊在另一側查看格式化後的輸出。

基本語法

標題

# Heading 1
## Heading 2
### Heading 3
#### Heading 4

標題應按層級使用。不要跳級（從 H1 直接跳到 H3）——這會影響可讀性和無障礙性。

強調

*italic* or _italic_
**bold** or __bold__
***bold italic***
~~strikethrough~~

連結和圖片

[Link text](https://example.com)
[Link with title](https://example.com "Title")
![Alt text](image.png)

列表

- Unordered item
- Another item
  - Nested item

1. First item
2. Second item
3. Third item

引用區塊

> This is a blockquote.
> It can span multiple lines.

程式碼

行內程式碼

使用反引號標記行內程式碼：`const x = 42`

程式碼區塊

使用三個反引號，並可選擇性地加上語言識別符：

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

支援的語言包括 javascript、python、json、yaml、html、css、bash 等多種語言。

表格

| Header 1 | Header 2 | Header 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

對齊方式：

| Left | Center | Right |
|:-----|:------:|------:|
| L    |   C    |     R |

進階語法

任務列表

- [x] Completed task
- [ ] Pending task
- [ ] Another task

註腳

Here is a statement[^1].

[^1]: This is the footnote content.

定義列表

Term
: Definition of the term

水平線

---
***
___

GitHub 風格 Markdown（GFM）

GitHub 在標準 Markdown 基礎上擴展了實用功能：

自動連結 URL — 裸露的 URL 會自動變為可點擊的連結
任務列表 — Issue 和 PR 中的核取方塊
表格 — 上方展示的管道語法
刪除線 — ~~deleted text~~
語法高亮 — 程式碼依語言著色
表情符號 — :smile: 會變成笑臉

撰寫技巧

保持段落簡短——最多 3-5 句
使用標題建立可快速瀏覽的結構
步驟或功能列表優先使用列表而非長段落
討論技術概念時加入程式碼範例
經常預覽——我們的 Markdown 預覽工具可在你打字時即時顯示輸出

常見問題

Markdown 和 HTML 有什麼區別？

Markdown 是一種簡化的寫作格式，可以轉換為 HTML。它用更少的語法涵蓋了最常見的格式需求。當 Markdown 不支援某些功能時，你可以在 Markdown 中嵌入原始 HTML。

應該使用哪種 Markdown 風格？

GitHub 風格 Markdown（GFM）是支援最廣泛的。它在標準 Markdown 基礎上增加了表格、任務列表和刪除線。CommonMark 是標準化的規範。

可以用 Markdown 撰寫文件嗎？

當然可以。Markdown 是 README 檔案、Wiki 和文件網站的標準格式。MkDocs、Docusaurus 和 GitBook 等工具都使用 Markdown。