Markdown 基礎語法格式

什麼是 Markdown？

Markdown 是一種輕量級標記語言，讓你用簡單的純文字語法來撰寫格式化文件。它由 John Gruber 於 2004 年創建，目標是讓文件在原始碼狀態下也能輕鬆閱讀。

為什麼要使用 Markdown？

簡潔易學：語法直覺，幾分鐘就能上手
廣泛支援：GitHub、GitLab、Notion、HackMD、VS Code 等工具都支援
專注內容：不需要滑鼠點按格式按鈕，雙手不離鍵盤就能完成排版
版本控制友好：純文字格式，非常適合搭配 Git 使用
多格式輸出：可以輕鬆轉換成 HTML、PDF、簡報等格式

Markdown 常見用途

撰寫技術文件與 README
部落格文章
筆記與知識管理
GitHub Issues 與 Pull Request 描述
電子郵件與訊息格式化

標題 (Headings)

使用 # 符號來建立標題，# 的數量代表標題層級（1-6 級）：

# H1 標題
## H2 標題
### H3 標題
#### H4 標題
##### H5 標題
###### H6 標題
Loading...

提示：# 與標題文字之間需要一個空格。一般建議文件中只使用一個 H1 標題，其餘使用 H2 以下。

段落與換行 (Paragraphs & Line Breaks)

段落之間需要一個空行來分隔：

這是第一個段落。

這是第二個段落。
Loading...

如果只需要換行而不是新段落，可以在行尾加上兩個空格後按 Enter，或使用 <br> 標籤：

第一行
第二行（前一行尾端有兩個空格）

第一行<br>
第二行（使用 HTML 的 br 標籤）
Loading...

文字強調 (Text Emphasis)

粗體 (Bold)

**這是粗體文字**
__這也是粗體文字__
Loading...

這是粗體文字

斜體 (Italic)

*這是斜體文字*
_這也是斜體文字_
Loading...

這是斜體文字

粗體加斜體 (Bold & Italic)

***這是粗體加斜體***
___這也是粗體加斜體___
Loading...

這是粗體加斜體

刪除線 (Strikethrough)

~~這是被刪除的文字~~
Loading...

~~這是被刪除的文字~~

醒目標記 (Highlight)

部分平台支援使用 == 來標記重點文字：

==這是醒目標記文字==
Loading...

列表 (Lists)

無序列表 (Unordered List)

使用 -、* 或 + 來建立無序列表：

- 項目 1
  - 子項目 1.1
  - 子項目 1.2
- 項目 2
  - 子項目 2.1
    - 子子項目 2.1.1
Loading...

項目 1
- 子項目 1.1
- 子項目 1.2
項目 2
- 子項目 2.1
  - 子子項目 2.1.1

有序列表 (Ordered List)

使用數字加上 . 來建立有序列表：

1. 第一項
2. 第二項
   1. 第二項的子項 1
   2. 第二項的子項 2
3. 第三項
Loading...

第一項
第二項
1. 第二項的子項 1
2. 第二項的子項 2
第三項

提示：有序列表的數字不需要按順序，Markdown 會自動編號。但建議還是按順序撰寫以提高原始碼的可讀性。

引用 (Blockquote)

使用 > 來建立引用區塊：

> 這是一個引用。

> 這是一個多行引用，
> 可以跨越多行。

>> 這是嵌套的引用。
Loading...

這是一個引用。

這是嵌套的引用。

引用區塊中也可以包含其他 Markdown 元素：

注意：引用中可以使用粗體、斜體、程式碼等格式。

也可以包含列表

非常實用

程式碼 (Code)

單行程式碼 (Inline Code)

使用反引號 ` 包裹程式碼：

使用 `console.log()` 來輸出訊息。
Loading...

使用 console.log() 來輸出訊息。

多行程式碼區塊 (Code Blocks)

使用三個反引號 ``` 並指定語言來建立程式碼區塊：

```javascript
function greet(name) {
  console.log(`Hello, ${name}!`)
}
```
Loading...

function greet(name) {
  console.log(`Hello, ${name}!`)
}
Loading...

常用的語言標示：javascript、python、bash、html、css、json、yaml、sql、go、rust 等。

差異對比 (Diff)

使用 diff 語言標示可以顯示程式碼變更：

```diff
- const old = 'removed'
+ const new = 'added'
```
Loading...

- const old = 'removed'
+ const new = 'added'
Loading...

超連結 (Links)

行內連結 (Inline Link)

[連結文字](https://www.example.com)
[帶標題的連結](https://www.example.com "滑鼠懸停時顯示的文字")
Loading...

連結文字

參考連結 (Reference Link)

適合在文件中多次使用同一個連結：

這是一段文字，其中包含[參考連結][1]和[另一個連結][example]。

[1]: https://www.example.com
[example]: https://www.example.com/page
Loading...

自動連結 (Autolink)

直接貼上 URL 或使用角括號：

<https://www.example.com>
<[email protected]>
Loading...

圖片 (Images)

![替代文字](https://picsum.photos/200/300)
![帶標題的圖片](https://picsum.photos/200/300 "圖片標題")
Loading...

替代文字

也可以使用參考連結的方式：

![替代文字][image-id]

[image-id]: https://picsum.photos/200/300 "圖片標題"
Loading...

提示：如果需要控制圖片大小，可以使用 HTML 的 <img> 標籤：
<img src="https://picsum.photos/200/300" width="200" alt="圖片描述">
Loading...

表格 (Tables)

使用 | 和 - 來建立表格：

| 標題 1 | 標題 2 | 標題 3 |
| ------ | ------ | ------ |
| 單元格 1 | 單元格 2 | 單元格 3 |
| 單元格 4 | 單元格 5 | 單元格 6 |
Loading...

標題 1	標題 2	標題 3
單元格 1	單元格 2	單元格 3
單元格 4	單元格 5	單元格 6

表格對齊 (Alignment)

使用 : 來控制對齊方式：

| 靠左對齊 | 置中對齊 | 靠右對齊 |
| :------- | :------: | -------: |
| 左 | 中 | 右 |
| 資料 | 資料 | 資料 |
Loading...

靠左對齊	置中對齊	靠右對齊
左	中	右
資料	資料	資料

任務列表 (Task Lists)

使用 - [ ] 和 - [x] 建立任務列表：

- [x] 已完成項目
- [x] 這個也完成了
- [ ] 尚未完成的項目
- [ ] 待辦事項
Loading...

已完成項目
這個也完成了
尚未完成的項目
待辦事項

分隔線 (Horizontal Rule)

使用三個或以上的 -、* 或 _ 來建立分隔線：

---
***
___
Loading...

跳脫字元 (Escaping Characters)

要顯示 Markdown 的特殊符號，可以用反斜槓 \ 來跳脫：

\* 不會變成斜體 \*
\# 不會變成標題
\[ 不會變成連結 \]
Loading...

可跳脫的字元：\、`、*、_、{}、[]、()、#、+、-、.、!、|

注腳 (Footnotes)

注腳可以為內容添加補充說明，而不影響正文的閱讀流暢度：

這是一段文字，附有注腳。[^1]

另一段文字也可以有注腳。[^note]

[^1]: 這是第一個注腳的內容。
[^note]: 注腳也可以使用文字作為識別標記。
Loading...

這是一段文字，附有注腳。¹

折疊區塊 (Collapsible Sections)

使用 HTML 的 <details> 標籤來建立可折疊的內容區塊：

<details>
<summary>點擊展開</summary>

這裡是被折疊的內容。

可以包含任何 Markdown 語法：
- 列表
- **粗體**
- `程式碼`

</details>
Loading...

這裡是被折疊的內容。

</details>

數學公式 (Math Equations)

部分平台（如 GitHub、HackMD）支援 LaTeX 數學公式：

行內公式

行內公式：$E = mc^2$
Loading...

行內公式：$E = mc^2$

獨立公式區塊

$$
\sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n
$$
Loading...

$$ \sum_{i=1}^{n} x_i = x_1 + x_2 + \cdots + x_n $$

自訂 HTML (Custom HTML)

Markdown 中可以直接嵌入 HTML 標籤，用於實現 Markdown 語法無法達成的排版效果：

<div style="text-align: center;">
  <h2>置中標題</h2>
  <p>這段文字是置中的。</p>
</div>

<kbd>Ctrl</kbd> + <kbd>C</kbd>

<mark>醒目標記文字</mark>

<sup>上標文字</sup> 和 <sub>下標文字</sub>
Loading...

GitHub 特殊語法 (GitHub Flavored Markdown)

GitHub 支援一些額外的 Markdown 語法：

提醒區塊 (Alerts)

> [!NOTE]
> 這是一則提示訊息。

> [!TIP]
> 這是一個實用的建議。

> [!IMPORTANT]
> 這是重要資訊。

> [!WARNING]
> 這是一則警告。

> [!CAUTION]
> 這是危險警告。
Loading...

表情符號 (Emoji)

:smile: :heart: :thumbsup: :rocket: :star:
Loading...

提及與參照 (Mentions & References)

@username          提及使用者
#123               參照 Issue 或 PR
SHA-hash           參照特定 commit
Loading...

最佳實踐

保持一致性：選定一種風格後（例如用 - 還是 * 作為列表符號），全文保持一致
善用空行：段落之間、標題前後加上空行，讓原始碼更易讀
使用標題建立結構：合理使用 H2-H4 標題，讓文件有清晰的層次結構
替代文字：圖片一定要加上替代文字，提升無障礙性
預覽確認：撰寫後使用預覽功能確認排版效果
善用程式碼區塊：指定語言以獲得語法高亮，提升可讀性

這是注腳的內容。 ↩