[markdown] markdown 基本語法指南

markdown 基本語法指南

markdown 是一種輕量級的標記語言，廣泛應用於文件撰寫、部落格等平台。它簡單易學，能有效地格式化文字。本文將介紹最常用的 Markdown 語法，適合初學者快速上手。

---

1. 標題

在 Markdown 中，標題使用 # 符號來表示，# 的數量決定了標題的層級（H1 到 H6）。例如：

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

顯示效果：

這是一級標題

這是二級標題

---

2. 段落與換行

段落不需要特別的標記，只需在文字間空一行即可。在同一行內按兩次空格則可以換行。

這是一個段落。

這是另一個段落。

顯示效果：

這是一個段落。
這是一段有兩個空格後的換行。
這是新段落。

---

3. 強調與字體樣式

使用 * 或 _ 來表示斜體，使用 ** 或 __ 來表示粗體。

*斜體* 或 _斜體_

**粗體** 或 __粗體__

顯示效果：

這是 粗體文字，這是 斜體文字。

---

4. 列表

Markdown 支援無序和有序列表。無序列表使用 -、* 或 +。有序列表使用數字和點號。

- 項目一
- 項目二

1. 項目一
2. 項目二

顯示效果：

1. 第一項
2. 第二項
   • 子項目一
   • 子項目二

• 子項目三
• 子項目四

---

5. 連結與圖片

連結使用 [顯示文字](網址) 格式。圖片的語法類似，但前面需要加上 !。

[Hexo 官方網站](https://hexo.io)

![示例圖片](https://example.com/image.png)

顯示效果：

Hexo

---

6. 程式碼區塊

行內程式碼使用反引號 ` 括起來，多行程式碼區塊則使用三個反引號 。

`行內程式碼`

多行程式碼區塊
```

### 顯示效果：
`行內程式碼`

多行程式碼區塊

---

## 7. 引用與水平線

引用文字使用 `>`，水平線則使用 `---`、`***` 或 `___`。

```markdown
> 這是一段引用。

---

> 這是一段多行引用的範例，  
> 它展示了如何處理超過一行的引用。  
> 可以在每行結尾使用雙空格來進行換行。

顯示效果：

這是一段引用。

---

這是一段多行引用的範例，
它展示了如何處理超過一行的引用。
可以在每行結尾使用雙空格來進行換行。

---

8. 組合語法

Markdown 支援將多個語法組合使用，例如在列表中加入引用或程式碼：

1. 第一項
    - 子項一
    - 子項二
2. 第二項
    > 引用文字
    ```markdown
    程式碼範例

### 顯示效果：
1. 第一項
    - 子項一
    - 子項二
2. 第二項
    > 引用文字
    ```markdown
    程式碼範例

---

9. 常見情境語法組合

9.1 引用與強調組合

引用和強調文字常用於強調重要信息：

> **注意：** 在安裝 Hexo 時，請確保 Node.js 已經更新到最新版本。

顯示效果：

注意： 在安裝 Hexo 時，請確保 Node.js 已經更新到最新版本。

9.2 列表與連結組合

列表中常會包含連結，以方便讀者進一步了解某個主題：

- [Markdown 官方網站](https://daringfireball.net/projects/markdown/)
- [Hexo 文件](https://hexo.io/docs/)

顯示效果：

• Markdown 官方網站
• Hexo 文件

---

10. 額外進階語法

10.1 表格

Markdown 也支援表格語法，用來展示結構化數據。

| 表頭一 | 表頭二 | 表頭三 |
| ------ | ------ | ------ |
| 單元格一 | 單元格二 | 單元格三 |

顯示效果：

表頭一	表頭二	表頭三
單元格一	單元格二	單元格三

10.2 勾選框列表

可以使用 [ ] 或 [x] 來表示待辦事項列表。

- [ ] 待辦事項一
- [x] 已完成事項

顯示效果：

• 待辦事項一
• 已完成事項

---

結語

Markdown 是非常靈活且易學的標記語言，無論是寫作還是技術文件，都能夠幫助您快速生成格式化的內容。希望這份指南能幫助您更好地掌握 Markdown 的基礎語法。