Markdown 基礎：建立 MD、標題與程式碼

Markdown 是用純文字標記檔案結構的寫法，副檔名通常是 .md。本篇會帶你建立一份能直接閱讀的專案說明，再用標題、清單、連結與程式碼表達規則。完成後，你就能讀懂 GEMINI.md 與 SKILL.md，也能分辨檔案內容和需要在終端機執行的命令。

開始前：準備文字編輯器

使用記事本、VS Code 或其他純文字編輯器即可。Windows 儲存時要留意「存檔型別」及副檔名；檔名看起來是 notes.md，實際卻可能是 notes.md.txt。先在檔案總管開啟副檔名顯示，再檢查完整名稱。macOS 的文字編輯如果使用富文字模式，須先轉為純文字，避免把格式資料寫進檔案。

建立一個練習資料夾，不必先安裝 Gemini CLI。Markdown 本身沒有登入、模型或付費方案，也不會自動執行裡面的程式。你可以離線編輯它；只有把檔案交給雲端工具時，才涉及工具的資料處理方式。請先用虛構資料練習，不要把帳號密碼當作專案背景。

先理解：標記與呈現是兩件事

井字號後加空格表示標題，一個井字號是檔案主標題，兩個或三個用來分層。不要只是為了放大文字而跳級；把「準備」「步驟」「驗證」當成同一層，讀者和工具都比較容易找到位置。段落之間留一個空白行，通常比只換行更能明確分開意思。

連字號後加空格是專案清單；數字、句點、空格則適合操作順序。連結寫成方括號中的文字接圓括號中的網址。檔案路徑要區分相對位置與完整網址：同資料夾的說明可以用相對路徑，但搬動檔案後也要檢查連結是否仍指向正確位置。

實作：建立第一份 MD 檔案

1. 在練習資料夾新增 notes.md，確認編碼是 UTF-8，讓繁體中文能跨裝置閱讀。
2. 貼上下面的內容，把任務名稱與完成條件改成自己的練習題。先維持標題階層，不急著加入複雜排版。
3. 儲存後關閉檔案，再重新開啟，確認中文、空格、符號與換行都保留。
4. 若編輯器提供 Markdown 預覽，開啟預覽比對原文。沒有預覽也沒關係，純文字應該已經容易閱讀。
5. 修改其中一個完成條件，重新儲存；檢查預覽是否同步變更，建立「編輯、儲存、確認」的習慣。

# 檔案摘要練習

## 任務
把一份公開活動公告整理成三個重點。

## 輸出規則
- 使用繁體中文。
- 保留活動日期與地點。
- 找不到的資訊寫「原文未提供」。

## 完成條件
1. 每個重點都能對回原文。
2. 不補上公告沒有寫的票價。

## 參考
[Gemini CLI 官方文件](https://geminicli.com/docs/)

範例中的標題與清單都是檔案內容，請貼到編輯器，不是 PowerShell。若要在檔案裡展示程式碼，可以用三個反引號包住程式區塊，開頭另外註明 python、json 等語言。一般行文中的短檔名則使用一對反引號；這些標記只是呈現方式，不代表裡面的命令已經執行。

檢查結果：讓另一個人照著做

好的 Markdown 檔案不只看起來整齊，也要讓人知道哪些內容是背景、哪些是要求、哪些是驗收。請把範例交給自己隔天再讀：如果只看「任務」就不知道要處理哪份資料，應補上輸入位置；如果「完成條件」只有「寫得好」，應改成能逐項檢查的標準。

可以再加入「不要做的事」，例如不要改動原始公告。這是工作範圍的文字說明，不是作業系統權限控制。真正控制 Gemini CLI 能存取哪些檔案，需要另外理解可信任資料夾與沙箱。將說明檔案當成權限隔離工具，會讓你誤判工具能做的事。

常見問題與下一次練習

整理多份教學時，可以在同資料夾建立 index.md，列出每一份檔案的名稱與用途，再在每篇文末加上回到 index.md 的連結。檢查連結時不要只看藍色文字是否出現，而要真正點開，確認檔名大小寫、空格及相對位置。這個小練習也能幫助你理解本系列的總目錄與文章互相連結如何運作。

當檔案要交給別人修改，可以把範例、規則與進度分成不同章節。範例中的假資料要明確標示，避免下一個人把它當成真實設定；已過時的段落則直接修正並留下版本記錄，不要在檔案底部不斷補上互相推翻的新要求。純文字容易比較差異，這正是它適合維護專案說明的原因。

標題沒有變成大字，常見原因是井字號後沒有空格，或你正在看純文字模式。先確認原始語法，再檢查編輯器是否支援預覽；不要因為沒有視覺效果就改成 Word 格式，否則檔案可能不再是純文字。

中文變亂碼時，先確認檔案編碼，另存 UTF-8 後重新開啟。若內容來自網頁，智慧引號、全形空格或複製附帶的特殊字元也可能影響程式範例。一般文字可以保留中文標點，JSON、TOML 與程式碼則要維持該語言要求的符號。

建立 .md 後 Gemini 沒有套用，是因為副檔名不等於工具設定。普通 notes.md 不會自動變成專案指示。完成本篇後，依GEMINI.md 入門放到指定位置，再透過記憶載入檢查確認工具真的讀到它。你也可以把同一份清單改寫成讀書計畫，練習保持結構而替換內容。

完成後的檢核

接著可以閱讀 GEMINI.md 入門、Agent Skills，把本篇的操作接到下一個工作流程。

返回 Gemini 教學總目錄

• AI 工具
• 教學
• 對話助理