Skip to main content

Markdown 語法快速教學

零、什麼是 Markdown＆為什麼要使用它

Markdown（MD） 是一種輕量級標記語言，由 John Gruber 提出，透過簡單的符號（如 #、*、- 等）即可在純文字中描述文件結構，並可轉換為 HTML、PDF 等格式。

使用 Markdown 的主要原因在於其高效率與可讀性：開發者或使用者不需要撰寫複雜的 HTML，即可快速建立格式清晰的文件；同時，Markdown 本身即具備良好的可讀性，即使未經轉換也能直接理解內容。此外，Markdown 為純文字格式，特別適合版本控制（如 Git），並廣泛應用於 GitHub、Notion 等平台，成為技術文件、筆記與專案說明的主流工具。

Markdown 提供了一種簡單、快速且跨平台的文件撰寫方式，能大幅提升文件整理與溝通效率。

一、標題（Headings）

使用 # 表示標題層級（1～6）

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

二、清單（Lists）

無序清單

- 項目 A
- 項目 B
    - 子項目 B1
        - 子項目 B1-1

或使用 *

* 項目 A
* 項目 B

有序清單

1. 第一點
2. 第二點
    1. 子項目
        1. 更深一層

三、換行（Line Break）

方法一（建議）

在行尾加兩個空格

這是一行  
這是下一行

方法二

使用 HTML：

<br />

四、文字樣式（Emphasis）

效果 語法 範例
粗體 **文字** 粗體
斜體 *文字* 斜體
粗斜體 ***文字*** 粗斜體
刪除線 ~~文字~~ 刪除

五、顏色（HTML 語法）

Markdown 原生不支援顏色，需要用 HTML：

這是一坨灰色的字
用車床時戴手套可能變成這個顏色
消化不良的時候大概就是這個顏色
TTR藍的色號"62c5e2"要背，考試會考
這是神聖乖乖的顏色 

<font color="#96999A">灰色</font>
<font color="#ff0000">紅色</font>
<font color="#62c5e2">藍色</font>

超連結

[Google](https://www.google.com)

👉 顯示： Google

圖片

![圖片說明](圖片網址)

![Markdown Logo](https://markdown-here.com/img/icon256.png)

七、程式碼（Code）

行內程式碼

使用 `git commit`

👉 使用 git commit

程式碼區塊

```python
def hello():
    print("Hello Markdown")


---

## 八、引用與分隔線

### 引用（Quote）

```markdown
> 這是一段引用

👉

這是一段引用

分隔線

---

九、表格（Tables）

| 項目 | 價格 | 備註 |
| :--- | :---: | ---: |
| 蘋果 | 30 | 左對齊 |
| 香蕉 | 20 | 置中 |
| 西瓜 | 100 | 右對齊 |

對齊說明

語法 對齊
:--- 左對齊
:---: 置中
---: 右對齊

十、重點整理（口訣）

  • 標題 → #
  • 清單 → - 或 *
  • 連結 → []()
  • 圖片 → ![]()
  • 程式碼 → `
  • 換行 → 空兩格 or <br />

延伸資源

Back to top