[其他] 什麼是 Markdown (.md)?初學者指南 (Gemini CLI 文檔)
如果你是程式初學者,剛開始接觸開發工具,像是需要為 Gemini CLI 寫規格文件,那麼你一定會遇到 .md 檔案。別擔心,這篇文章會用最簡單的方式解釋什麼是 Markdown (.md),並教你如何用它來寫出清楚的規格文檔。讓我們一步步來! Markdown 是什麼? Markdown 是一種「輕量級標記語言」(lightweight markup language),它讓你可以用簡單的文字符號來格式化內容,而不需要複雜的 HTML 程式碼。它的檔案副檔名通常是 .md(來自 Markdown 的縮寫)。 想像一下,你在寫筆記或文件時,想加粗文字、做清單或插入程式碼區塊。Markdown 讓這些變得超簡單!它最初是由 John Gruber 在 2004 年發明的,現在廣泛用在 GitHub 的 README.md、部落格文章、甚至是像 Gemini CLI 這樣的工具規格文件中。 為什麼適合程式初學者?因為 Markdown 不需要學太多規則,就能快速寫出專業的文檔。尤其是當你用 Gemini CLI 時,規格文件通常是用 .md 格式,方便工具讀取和顯示。 為什麼需要用 Markdown 寫規格給 Gemini CLI? Gemini CLI(假設你是用 Google 的 AI 工具 CLI 版本)常常要求輸入規格文件來生成程式碼、API 或其他輸出。這些規格用 .md 寫,因為: 易讀性高:人類和機器都能輕鬆理解。 版本控制友好:用 Git 管理時,.md 檔案小巧且易追蹤變化。 跨平台:可以用任何文字編輯器(如 Notepad、VS Code)編寫,不需要特殊軟體。 例如,你可能需要寫一個 API 規格的 .md 文件,描述端點、參數和範例,然後餵給 Gemini CLI 讓它幫你生成程式碼。 Markdown 的基本語法 讓我們來看一些常用語法。記住,Markdown 是用純文字寫的,符號會自動轉換成格式。以下是初學者必學的: 1. 標題(Headers) 用 # 符號來表示層級。越多 #,標題越小。 # 這是一級標題 ## 這是二級標題 ### 這是三級標題 顯示效果: 這是一級標題 這是二級標題 這是三級標題 2. 粗體和斜體(Bold & Italic...