Skip to content

建立 2026-09-15 更新 2026-09-15

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 再上線。

建議學習路徑

  1. 認識 VitePress:它解決什麼問題、跟 VuePress 差在哪。
  2. 快速開始:安裝、專案結構、三個指令。
  3. 撰寫內容:Markdown 擴充、檔案路由、在文件裡用 Vue。
  4. 主題與設定:config、頂欄/側欄、首頁 hero。
  5. 佈署上線:GitHub Pages 與常見平台。
  6. 影音教學:邊看邊對照本站文章。
  • 認識 VitePress


    它是什麼、適用場景,以及為什麼 Vue 生態現在推薦它。

    開始認識

  • 從安裝到預覽


    Node.js、vitepress init、資料夾長什麼樣子、本機怎麼跑。

    快速開始

  • 把內容寫出來


    程式碼區塊、提示框、內部連結,以及 Markdown 裡的 Vue 元件。

    撰寫內容

  • 影音對照


    作者研討會演講,以及 LearnVue、This Dot 等頻道的逐步示範。

    觀看影音

官方學習資源

VitePress 沒有官方證照課程(Certificate program)。學習仍以官方文件為準,影音則以作者演講與社群優質教學為輔。

官方文件(含繁/簡中文)

vitepress.dev中文文件 是第一手來源。本站寫精要,細節與新語法請回官方對照。

官方線上試用

不想先裝環境,可用官方提供的 StackBlitz 線上範例 直接在瀏覽器裡改 Markdown。

官方/作者影音

VitePress 沒有獨立的官方 YouTube 頻道。最接近「官方」的是作者 Evan You 的研討會演講,已整理在 官方影音

想認識唯客學院,請看 關於我們