為什麼選擇 VitePress
選工具前先問兩件事：內容是不是以 Markdown 為主？讀者是不是以「讀文件、查語法」為主？兩個都是，VitePress 通常是 Vue 生態裡最省事的答案。
跟 VuePress 的關係
VitePress 的靈感來自 VuePress。VuePress 1 建立在 Vue 2 與 webpack 上；VitePress 改用 Vue 3 與 Vite，開發伺服器啟動更快、熱更新幾乎不閃頁、預設主題也更完整。
Vue 團隊已決定長期只主推 VitePress 這一套 SSG：VuePress 1 停止維護，VuePress 2 交給社群。若你現在要開新的文件站，應直接用 VitePress，不必再從 VuePress 起步。
兩者差異主要在主題與自訂 API，不在「用 Markdown 寫頁面」這件事。從 VuePress 1 預設主題遷過來通常不算大工程，細節見官方說明。
它比一般 SSG 多什麼
- Vite 開發體驗：改 Markdown 或 Vue 元件，瀏覽器幾乎立刻更新。
- 文件向的 Markdown 擴充：行高亮、程式碼分組、提示框、從檔案匯入片段，都是為技術文件準備的。
- 頁面就是 Vue 元件：靜態說明裡可以嵌一個可點的示範，不必另開 CodePen。
- 預設主題夠用：頂欄、側欄、搜尋、暗色模式、上一頁／下一頁，文件站常用的都有。
什麼時候不要用
- 需要會員系統、購物車、即時通知：選 Nuxt 或其他應用框架。
- 團隊完全不碰 Node.js／JavaScript：可考慮 MkDocs、Zensical 等 Python 工具鏈（本站本身就是 Zensical）。
- 只要一份 PDF 講義、不需要網站：用 Markdown 編輯器匯出即可，不必上 SSG。
跟「本站用的 Zensical」差在哪
兩者都是「Markdown → 靜態文件網站」，定位接近：
| VitePress | Zensical | |
|---|---|---|
| 執行環境 | Node.js | Python |
| 畫面與互動 | Vue 3 | 接近 Material for MkDocs |
| 擅長 | Vue 元件示範、Vite 外掛生態 | 課程講義、既有 Material 寫作習慣 |
選 VitePress 的典型理由是：專案已經在 Vue／Vite 生態，或文件裡需要可互動的元件範例。