VitePress 教學
VitePress 是 Vue 團隊維護的靜態網站產生器(Static Site Generator, SSG):用 Markdown 寫內容,套上主題後產出可佈署到任何地方的靜態 HTML。Vue、Vite、Vitest、Pinia 等官方文件都用它來做文件站。
本站用繁體中文整理「先學會就能自己架站」的那一小段核心,再把官方文件、作者演講與 YouTube 優質教學對應到各個主題。
最必須掌握的 20%
學會下面這組觀念,就能從空白專案走到可上線的文件站。其餘主題(自訂主題、資料載入、動態路由)等真正需要時再查官方文件即可。
| 先抓住什麼 | 為什麼重要 |
|---|---|
| Markdown 寫內容 | 每一頁都是 .md,專心寫講義,不必先學整套前端框架。 |
| 檔案即路由 | docs/guide/install.md 對應網址 /guide/install,不用另外配路由表。 |
.vitepress/config 控全站 |
站名、搜尋、頂欄 nav、側欄 sidebar 都在這一份設定。 |
| 三個指令 | dev 本機預覽、build 產出靜態檔、preview 檢查正式版。 |
base 路徑 |
佈署到 example.com/專案名/ 時一定要設,否則 CSS 與連結會全部 404。 |
用一句話串起來:寫 Markdown → 在 config 掛導覽 → build 出靜態站 → 設對 base 再上線。
建議學習路徑
- 認識 VitePress:它解決什麼問題、跟 VuePress 差在哪。
- 快速開始:安裝、專案結構、三個指令。
- 撰寫內容:Markdown 擴充、檔案路由、在文件裡用 Vue。
- 主題與設定:config、頂欄/側欄、首頁 hero。
- 佈署上線:GitHub Pages 與常見平台。
- 影音教學:邊看邊對照本站文章。
官方學習資源
VitePress 沒有官方證照課程(Certificate program)。學習仍以官方文件為準,影音則以作者演講與社群優質教學為輔。
官方文件(含繁/簡中文)
vitepress.dev 與 中文文件 是第一手來源。本站寫精要,細節與新語法請回官方對照。
官方線上試用
不想先裝環境,可用官方提供的 StackBlitz 線上範例 直接在瀏覽器裡改 Markdown。
想認識唯客學院,請看 關於我們。