Markdown 與 MkDocs 課程簡介

課程目標

本課程主要目標在使學員短時間內熟練掌握 Markdown 的基本與進階用法，以及學習如何使用 MkDocs 建立和管理文件。希望學員能夠有效地建立、編輯和部署技術文件的靜態網站，以便應用於專案技術文件編輯與管理。

學習重點

• Markdown 基礎與進階技巧：從格式化到複雜元素的處理。
• MkDocs 使用與配置：學習如何安裝、配置及定義 MkDocs 設定檔。
• 實戰演練與部署：實際操作建立完整網站並學會部署到 GitLab Pages。

習作與練習

• 習作：建議可依照習作與展示主題進度，或依自己學習節奏，自行練習。
• 結訓：可利用介紹 angular 語法或 git 操作為例，練習使用 MkDocs，並部署到 GitLab Pages。也可自行選擇其他感興趣的軟體技術說明為主題。但內容應包含標題、程式碼區塊、列表、表格、圖片、鏈接等基本元素。

展示與討論

• 展示：課程結束時，學員需展示自己的 MkDocs 項目並進行簡報。
• 討論：簡報中，學員可在課堂上提出問題，並與老師和同學進行討論。