Markdown編程課程

實體編程教學課程內容

課程簡介

本課程為三小時密集入門班，專為寫作者、技術文件編輯者、開發人員與數位內容製作者設計。Markdown 是一種輕量級標記語言，能以簡潔的語法快速格式化文字，生成結構清晰、美觀可轉換為 HTML、PDF 或展示頁面的文件。

課程將從基礎語法介紹開始，教學員如何使用 Markdown 寫出兼具結構與排版的文件，並延伸至表格、程式碼、目錄與圖片嵌入等功能。同時介紹常見的 Markdown 工具如 Typora、Obsidian、VS Code 與 GitHub README 製作應用。完成課程後，學員將能高效撰寫技術文件、簡報、部落格與專案說明文件，提升工作產出與協作效率。

課程目標

1. 理解 Markdown 語言結構與用途。

2. 掌握常用 Markdown 標記語法與結構排版技巧。

3. 能撰寫結構清晰的說明文件、筆記或網頁內容。

4. 應用延伸語法（表格、程式碼區塊、清單、連結與圖片）。

5. 了解 Markdown 在 GitHub、Notion、Obsidian 等平台的實際應用。

授課對象

• 無論技術與非技術背景，欲學習高效文字編排與文件格式化者。

• 技術人員、開發者、內容編輯、文件撰寫與教育研究人員。

• 希望提升筆記管理、報告編排或技術文件品質的使用者。

• 企業員工培訓、開發團隊知識管理及學生專案文件編寫者。

課程大綱

第一部分：Markdown 基礎與編輯環境（約 40 分鐘）

• Markdown 的起源與用途。

• Markdown 與 HTML、Word 的差異。

• 常用編輯器介紹：Typora、Obsidian、VS Code、StackEdit。

• Markdown 文件結構與轉檔原理。

• 實作練習：建立第一個 Markdown 文件並輸出為 HTML / PDF。

第二部分：基礎語法與文字格式（約 60 分鐘）

• 標題（Heading）與段落排版。

• 文字樣式：粗體、斜體、刪除線、高亮。

• 清單（List）與層級控制。

• 引用（Blockquote）與分隔線（Horizontal Rule）。

• 連結（Link）與圖片（Image）插入方式。

• 實作練習：撰寫結構完整的技術教學文件。

第三部分：進階語法與實際應用（約 45 分鐘）

• 程式碼區塊（Inline Code / Code Block）與語法高亮設定。

• 表格（Table）與對齊格式。

• 目錄（Table of Contents）自動生成與文件導覽。

• 註解（Comment）與特殊字元處理。

• 實作練習：建立有程式碼與表格的專案說明書。

第四部分：Markdown 在工作流程中的應用（約 35 分鐘）

• GitHub README 文件設計原則。

• Markdown 與版本控制（Git）整合。

• Markdown + Obsidian 筆記管理與超連結資料庫。

• 延伸應用：簡報（Marp）、部落格（Jekyll / Hugo）、知識文件系統。

• 實作練習：製作個人作品集或團隊簡報頁文件。

課程特色

• 三小時完成 Markdown 語法與實作精華學習。

• 強調「實用導向」與文件美觀結構化。

• 無程式基礎亦可輕鬆學會，適合跨領域使用。

• 課程結束後可銜接進階課程：Markdown + GitHub Pages、Obsidian 知識管理、Marp 簡報製作。