Session 4
⏱ 90 min
零程式基礎可上手
Markdown 入門
寫給人看，也寫給 AI 看
純文字就能排版、做筆記、寫說明書——更重要的是，它是你控制 AI Agent 行為的語言。
檔案格式
›
Web 基礎
›
CLI + Ollama
›
Markdown（本週）
›
Colab / API
›
部署
0 – 15 min
概念導入
為什麼 Markdown？
15 – 45 min
語法實作
基本到進階，即時預覽
45 – 75 min
AGENTS.md 撰寫
用 Markdown 指揮 AI
Part 1 · 0 – 15 min
Markdown 是什麼？為什麼你需要學它？
Markdown 是一種輕量標記語言——用極少的特殊符號，讓純文字變得有結構。你不需要 Word，不需要 HTML，只要一個文字編輯器。
你輸入的 .md 檔→渲染後的樣子
# 魯迅
**原名**周樹人，浙江紹興人。
> 橫眉冷對千夫指，
> 俯首甘為孺子牛。
- 《呐喊》1923
- 《彷徨》1926
魯迅
原名周樹人，浙江紹興人。
橫眉冷對千夫指，
俯首甘為孺子牛。
三個你需要 Markdown 的理由
📝
筆記與文件
GitHub、Notion、HackMD、Obsidian 全部使用 Markdown。學一次，到處通用。
🌐
網頁內容
本課程的所有 Lab 頁面，底層都是 Markdown 轉成 HTML。Jekyll、Hugo 靜態網站也是。
🤖
指揮 AI
AGENTS.md、CLAUDE.md、system prompt——控制 AI Agent 行為的核心檔案，全部都是 Markdown。
🔓
永遠可讀
純文字，不依賴任何軟體。十年後、換了作業系統，用記事本也能打開。
課程定位：本週學的 Markdown，是下週寫 AGENTS.md 的基礎。你在 Markdown 裡寫的每一個標題、每一條規則，都會變成 AI 讀取的指令結構。
Part 2 · 15 – 45 min
核心語法：12 個符號就夠了
標題層級
Markdown
# 一級標題（文件名稱）
## 二級標題（大章節）
### 三級標題（小節）
#### 四級標題（少用）
渲染結果
一級標題（文件名稱）
二級標題（大章節）
三級標題（小節）
四級標題（少用）
AI 讀取的視角：標題不只是讓人看的視覺層級——AI 在解析 AGENTS.md 時，用標題來識別不同的指令區塊。# 角色設定 和 # 工具限制 是兩個不同的命令區域。
文字強調
Markdown
**粗體**（重要規則用這個）
*斜體*（術語或書名）
~~刪除線~~（已廢棄的規則）
`程式碼`（指令、路徑、變數名稱）
渲染結果
粗體（重要規則用這個）
斜體（術語或書名）
刪除線（已廢棄的規則）
程式碼（指令、路徑、變數名稱）
清單
Markdown
- 無序清單（用 - 或 *）
- 第二項
- 縮排兩格 = 子清單
1. 有序清單
2. 會自動編號
3. 第三項
引用與程式碼區塊
Markdown
> 引用文字（blockquote）
> 適合放規則說明或警告
```python
# 程式碼區塊（三個反引號）
print("Hello, Markdown!")
```
渲染結果
引用文字（blockquote）
適合放規則說明或警告
# 程式碼區塊（三個反引號）
print("Hello, Markdown!")
連結、圖片、水平線
Markdown
[顯示文字](https://example.com)
--- ← 水平分隔線（三個 -）
表格
Markdown
| 台灣用語 | 中國用語 | 英文原詞 |
|---------|---------|---------|
| 軟體 | 軟件 | Software |
| 滑鼠 | 鼠標 | Mouse |
渲染結果
| 台灣用語 | 中國用語 | 英文原詞 |
|---|
| 軟體 | 軟件 | Software |
| 滑鼠 | 鼠標 | Mouse |
互動練習
即時預覽編輯器
在左側輸入 Markdown，右側即時看到渲染結果。試著修改、刪除、加入新語法。
✏️ 課堂練習一（10 min）
- 把左側的研究主題改成你自己感興趣的領域
- 在表格裡加入至少兩個你自己找的對比詞彙
- 試著加入一個
```python 程式碼區塊，裡面放任何一行 Python（不用能跑）
- 觀察：標題的層級和清單的縮排，哪些地方的結構感最強？
Part 3 · 45 – 75 min
從 Markdown 到 AGENTS.md：用文字指揮 AI
現在把剛學的語法用在真正的目的上。AGENTS.md 就是一份 Markdown 文件——但它的讀者不是人，是 AI coding agent。你在這份文件裡寫的每一行，都會在 AI 開始工作之前被讀取，成為它的「工作守則」。
結構即指令：# 角色設定 這個標題，讓 AI 知道「這個區塊是在定義我的身份」。## 禁止行為 這個標題，讓 AI 知道「這個區塊是邊界規則」。Markdown 的結構，直接對應 AI 的認知區塊。
一份 AGENTS.md 的標準結構
典型 AGENTS.md 的骨架（Markdown 語法 + 說明）
# 專案名稱與概述 ← H1：給 AI 定錨（這是什麼專案）
## 角色與身份 ← H2：這個 AI 扮演什麼角色
你是一名台灣文學研究助理...
## 可以使用的工具 ← H2：能力範圍
- 搜尋學術資料庫
- 讀取 .txt 和 .md 檔案
- **不可以** 修改原始語料
## 工作流程 ← H2：思考與行動的順序
1. 先閱讀使用者的問題
2. 確認需要哪些資料
3. 回應前列出你的推理步驟
## 輸出格式 ← H2：回應的形式要求
- 用繁體中文回答
- 引用文本時用 `>` 引用格式
- 每段分析不超過 200 字
## 限制與邊界 ← H2：不該做的事
> **絕對不可以** 捏造不存在的引文。
> 不確定時說「我不確定」，不要猜測。
互動式 AGENTS.md 產生器
填入以下欄位，即時看到對應的 AGENTS.md 內容。這就是你下週要提交的作業雛形。
AGENTS.md 產生器
# （請填寫上方欄位，AGENTS.md 會在這裡即時產生）
✏️ 課堂練習二（15 min，兩人一組）
- 設計一個你想要的 AI 助理：可以是論文寫作助理、語料整理助理、田野筆記分析助理……
- 用上面的產生器填寫，觀察 Markdown 結構和你填的內容的對應關係
- 把產生的 AGENTS.md 複製到你的 HackMD 或 VS Code，確認渲染結果正確
- 討論：如果你的 AI 助理沒有「限制與邊界」那個區塊，會發生什麼？
進一步：system prompt vs AGENTS.md
System Prompt（聊天介面用）自由格式
你是一名台灣文學研究員，
專長是日治時期的文學分析。
請用繁體中文回答，
不要捏造引文。
AGENTS.md（程式 / 工具用）結構化 Markdown
# 台灣文學研究助理
## 角色
台灣文學研究員，專長日治時期。
## 輸出格式
- 語言：繁體中文
## 限制
> 不得捏造引文。
重要差異：System prompt 是「對話層」的指令，只在一次對話裡有效。AGENTS.md 是「專案層」的指令，會被 Cursor、Claude Code、Codex 等工具在每次工作開始前自動讀取——它的效力更持久，也更系統性。
速查表
Markdown 語法速查
標題
# 文字一級標題（最大）
## 文字二級標題
### 文字三級標題
強調
**文字**粗體
*文字*斜體
`文字`行內程式碼
~~文字~~刪除線
清單
- 項目無序清單
1. 項目有序清單
- 子項縮排兩格 = 子清單
區塊
> 文字引用（blockquote）
```程式碼區塊（首尾各三個）
---水平分隔線
連結與圖片
[文字](url)超連結
插入圖片
表格
| A | B |表格列
|---|---|分隔線（必須有）
| a | b |資料列
Part 4 · 75 – 90 min
本週總結 × 下週預告
✓
Markdown 語法
標題、強調、清單、表格、引用、程式碼區塊
✓
即時預覽
在瀏覽器裡看到 Markdown → HTML 的轉換過程
✓
AGENTS.md 結構
用標題劃分角色、工具、流程、限制四個區塊
→
下週：Colab + API
把你寫的 AGENTS.md 真正「餵給」AI，觀察它如何改變模型行為
📚 課後作業
- 在 HackMD 或本機建立一個
AGENTS.md，定義一個你想要的研究助理（至少包含：角色、可以做的事、禁止的事、輸出格式）
- 為你的
AGENTS.md 加入至少一個 Markdown 表格（例如：研究材料清單、詞彙對照表）
- （選做）把同一份
AGENTS.md 的內容貼到 Claude 的對話框裡當 system prompt，問它一個問題，觀察它是否按照你的規則回應