基礎 01
標題（Headings）
使用 # 到 ###### 表示 1 到 6 層標題。
Markdown 寫法
# 第一層標題
## 第二層標題
### 第三層標題效果預覽
📘 香港編程學院 | Markdown課程
Markdown 完整繁體中文教學網站
從入門到實作，系統學會 Markdown 的核心語法、常見延伸語法、實務應用方法， 並透過互動練習與測驗快速上手。
8+
核心語法單元
4+
互動功能模組
10
題小測驗
# 我的 Markdown 筆記
## 今日待辦
- [x] 學會標題
- [x] 學會清單
- [ ] 學會表格
> Markdown 很適合 README、技術文件與學習筆記。
[官方網站](https://commonmark.org)
```js
console.log("Hello Markdown!");
```入門導讀
認識 Markdown
Markdown 是一種輕量標記語法，目標是讓你用簡單文字符號快速撰寫格式化文件， 同時保留原始文字的可讀性。它特別適合筆記、README、技術文件、部落格草稿與知識庫整理。
容易撰寫
只需要少量符號，例如 #、-、>、` 就能完成排版。
容易閱讀
即使不經過渲染，Markdown 原始文字仍然具備良好的結構與可讀性。
容易轉換
Markdown 常被轉換為 HTML，也能整合進 GitHub、靜態網站、筆記工具與文件系統。
重要觀念：
核心 Markdown 語法通常相容性高，但表格、任務清單、註腳、警示框等功能，常屬於延伸語法，不一定在所有平台都完全一致。
核心語法
Markdown 基本語法教學
可先透過分類頁籤快速理解，再往下看每一個語法卡片的寫法與效果。
標題
使用 # 到 ###### 對應 1 到 6 層標題。
段落
段落之間用空行分隔，不建議一般段落使用縮排。
強調
使用 * 或 _ 製作斜體、粗體與粗斜體。
無序清單
可用 -、* 或 +，但同一清單建議一致。
有序清單
使用數字加句點，例如 1.、2.。
引用區塊
行首加 > 建立引用，也可做巢狀。
連結
使用 [文字](網址) 建立超連結。
圖片
使用  插入圖片。
替代文字
圖片建議撰寫清楚的 alt 文字，有助於可及性與理解。
行內程式碼
使用反引號 ` 包住短程式碼片段。
程式碼區塊
使用三個反引號建立多行程式碼區塊。
分隔線
使用 ---、*** 或 ___ 建立分隔線。
基礎 02
段落與換行
段落之間使用空行；強制換行常見做法是在行尾加兩個空白或使用 <br>。
Markdown 寫法
這是第一段。
這是第二段。
這一行會換行。效果預覽
這是第一段。
這是第二段。
這一行會換行。
基礎 03
粗體、斜體、粗斜體
使用星號或底線標示強調，實務上通常較常見星號版本。
Markdown 寫法
*斜體*
**粗體**
***粗斜體***效果預覽
斜體
粗體
粗斜體
基礎 04
引用（Blockquotes）
用於摘要、註解、提醒、名言，也可巢狀引用。
Markdown 寫法
> Markdown 讓文件更易讀。
>
>> 這是巢狀引用。效果預覽
Markdown 讓文件更易讀。這是巢狀引用。
基礎 05
清單（Lists）
無序清單使用 -、* 或 +；有序清單用數字加句點。
Markdown 寫法
- 蘋果
- 香蕉
- 葡萄
1. 安裝
2. 設定
3. 開始使用效果預覽
- 蘋果
- 香蕉
- 葡萄
- 安裝
- 設定
- 開始使用
基礎 06
連結與圖片
超連結使用 [文字](網址)；圖片則在前面加 !。
Markdown 寫法
[前往網站](https://example.com)
效果預覽
圖片顯示位置（教學示意）
基礎 07
行內程式碼與程式碼區塊
行內程式碼用反引號，多行程式碼常用三個反引號包住。
Markdown 寫法
請執行 `npm install`
```python
def hello():
print("Hello")
```效果預覽
請執行 npm install
def hello():
print("Hello")基礎 08
分隔線（Horizontal Rule）
可用 ---、*** 或 ___ 建立分隔線。
Markdown 寫法
前一段
---
下一段效果預覽
前一段
下一段
最佳實務
CommonMark / 相容性建議
如果你希望 Markdown 在不同平台更穩定顯示，以下做法非常值得遵守。
推薦做法
- 標題的
#後面加一個空格 - 標題前後保留空行
- 段落之間用空行分隔
- 同一個清單使用一致符號
- 網址中的空格轉成
%20 - 需要字面顯示特殊符號時使用反斜線跳脫
常見錯誤
- 把一般段落當成清單內容亂縮排
- 在同一份清單中混用
-與* - 以為所有平台都支援表格、任務清單、註腳
- 在 HTML 區塊內期待 Markdown 一定能正常解析
- 忘記為圖片撰寫清楚的替代文字
提醒：
若你的文件是要跨不同編輯器、筆記軟體與網站系統使用，越接近核心語法，通常越穩定。
延伸語法
GitHub Flavored Markdown（GFM）常見延伸
下面列出在 GitHub 與許多現代工具中常見的延伸功能，但不保證每個 Markdown 解析器都支援。
| 功能 | 寫法 | 用途 | 支援提醒 |
|---|---|---|---|
| 表格 | | 欄1 | 欄2 | |
用於比較資訊、整理規格 | 常見但屬延伸語法 |
| 任務清單 | - [ ] / - [x] |
待辦事項、進度追蹤 | 常見於 GitHub 與筆記工具 |
| 程式碼高亮 | ```js |
為程式碼指定語言 | 是否上色依平台而異 |
| 註腳 | 文字[^1] |
補充註釋、學術整理 | 不是所有系統都支援 |
| 警示區塊 | > [!NOTE] |
提醒、警告、提示 | 常見於 GitHub 類環境 |
表格範例
Markdown 寫法
| 語法 | 功能 |
|---|---|
| # | 標題 |
| - | 清單 |
| ` | 程式碼 |效果預覽
| 語法 | 功能 |
|---|---|
| # | 標題 |
| - | 清單 |
| ` | 程式碼 |
任務清單範例
Markdown 寫法
- [x] 完成首頁
- [ ] 新增題庫
- [ ] 補 FAQ效果預覽
- ☑ 完成首頁
- ☐ 新增題庫
- ☐ 補 FAQ
教學標示建議：
在你的網站中可把「核心語法」與「延伸語法」分開，讓學習者理解哪些功能是各平台幾乎都能用，哪些功能比較依賴平台支援。
互動練習
Markdown 練習區｜即時預覽
左邊輸入 Markdown，右邊即時顯示預覽。這個示範版內建的是簡化解析器，足夠學習常見語法； 若日後你要升級成正式編輯器，可以再串接更完整的 Markdown 解析函式庫。
編輯器
即時預覽
實務應用
常見應用模板
你可以直接複製以下模板做修改，快速用在作業、專案或工作情境中。
README 模板
適合 GitHub 專案首頁介紹。
# 專案名稱
## 專案介紹
簡短描述這個專案的用途。
## 功能特色
- 功能一
- 功能二
- 功能三
## 安裝方式
```bash
npm install
```
## 使用方式
```bash
npm run dev
```
## 授權
MIT課堂筆記模板
適合學校課程或自學整理。
# 第 X 章筆記
## 重要概念
- 概念一
- 概念二
- 概念三
## 關鍵名詞
- 名詞 A：說明
- 名詞 B：說明
## 老師提醒
> 這裡記錄重要提醒或考點。
## 我的心得
寫下自己的理解與補充。會議紀錄模板
適合社團、專案、團隊討論。
# 會議紀錄
## 會議資訊
- 日期：
- 時間：
- 與會者：
## 討論重點
1. 議題一
2. 議題二
3. 議題三
## 決議事項
- 決議一
- 決議二
## 待辦事項
- [ ] 任務 A
- [ ] 任務 B快速記憶
語法翻卡練習
點擊卡片可翻面，快速記住常見 Markdown 語法。
如何建立一級標題？
點我翻面
# 標題
在文字前加上一個 #，並保留一個空格。
如何建立無序清單？
點我翻面
- 清單項目
可使用 -、* 或 +。
如何建立超連結？
點我翻面
[文字](網址)
例如 [Google](https://google.com)
如何建立行內程式碼？
點我翻面
`程式碼`
用反引號包住，例如 `npm run dev`
學習檢核
Markdown 小測驗
作答後按下批改，系統會顯示分數與每題解析。
1. 哪一個是第二層標題的正確寫法？
正解是 ## 第二層標題。
2. 哪一個是粗體語法？
正解是 **文字**。
3. 行內程式碼使用哪個符號包起來？
正解是反引號
`。4. 哪一個是圖片語法？
正解是 ，圖片語法比連結多一個驚嘆號。
5. 哪一項通常屬於延伸語法，而非所有 Markdown 都保證支援？
正解是 任務清單。像
- [ ]、- [x] 通常屬於 GitHub Flavored Markdown 等延伸語法。6. 哪一個寫法可以建立引用區塊？
正解是 > 引用文字。
7. 哪一個是正確的超連結寫法？
正解是 [Google](https://google.com)。
8. 多行程式碼區塊最常見的寫法是什麼？
正解是 使用三個反引號包住內容，例如
```js 開頭、``` 結尾。9. 下列哪一個可以建立分隔線？
正解是 ---。另外
*** 與 ___ 也常見。10. 下列哪個功能最常被視為 GitHub 等平台的延伸功能？
正解是 表格。它非常常見，但通常被視為延伸語法而非最早期核心語法之一。
FAQ
常見問題
以下整理初學者最常遇到的 Markdown 疑問。
Markdown 一般被視為輕量標記語言，主要用來撰寫格式化文件，而不是像 JavaScript、Python 那樣的傳統編程語言。
Markdown 比 HTML 更簡潔、更容易手寫；HTML 則更完整、可控制的細節更多。很多情況下，Markdown 最終會被轉換成 HTML 顯示。
因為不同平台使用的 Markdown 解析器與支援功能不完全相同。核心語法通常差異較小，但表格、任務清單、警示框、註腳等延伸語法，支援度可能不同。
最常用的是：標題、段落、清單、連結、圖片、程式碼區塊。這幾種就足以完成大多數 README。
許多平台支援在 Markdown 中混用部分 HTML，但不是所有平台都完全一致，而且某些 HTML 區塊內不一定能再正確解析 Markdown。