VitePress vs Quartz vs Docusaurus:三個靜態站產生器的功能與場景比較

2 分鐘閱讀時長

發布時間:

VitePress vs Quartz vs Docusaurus:三個靜態站產生器的功能與場景比較

這三個專案常被放在一起搜尋——它們都是 TypeScript 寫成、MIT 授權的靜態站產生器(SSG),但它們解答的其實是三個不同的問題。本文以 2026-11-16 的 GitHub API 驗證數據為基礎,比較功能矩陣與適用場景。

基本盤

 VitePressQuartz (v5)Docusaurus
倉庫vuejs/vitepressjackyzha0/quartzmeta/docusaurus
定位自述Vite & Vue 驅動的文件站把筆記發佈成網站的「數位花園」工具易於維護的開源專案網站
星數18,49113,59666,747
Fork2,7594,14410,140
授權MITMITMIT
創建2020-042021-072017-06
最新版本v2.0.0-alpha.21(2026-10-25)v5.1.0(2026-11-09)v3.10.2(2026-07-10)
維護者Evan You(Vue 作者)+ VoidZero/Vue 生態贊助個人開發者 jackyzha0(讚助手計畫)Meta(倉庫要 facebook/docusaurus 已遷移至 meta 組織)
最近 push2026-11-122026-11-152026-11-15
開放議題38172441

三個都在活躍維護。值得留意的是版本態勢:VitePress 正式版停在 v1.x,v2.0 仍在 alpha(alpha.21);Quartz 已演進到完全重寫的 v5;Docusaurus 在 v3 線上穩定小步快跑。

定位:一句話版

  • VitePress:「Vue 生態的 Vite 文件站」。Markdown 檔案就是頁面、內嵌 Vue SFC 就是互動元件,開發伺服器與建置都騎在 Vite 上。VuePress 的精神繼承者。
  • Quartz:「把 Obsidian/Markdown 筆記變成双向連結的知識網站」。重點不是文件結構,而是筆記之間的連結圖:wikilink、反鏈、圖譜、彈出預覽,全站靜態產出。
  • Docusaurus:「開源專案的官網基建」。文件+版本化文件+部落格+多語言+主題設定,一個 CLI 生成,Meta 用來支撐自家大量 OSS 專案的官網。

功能矩陣

功能VitePressQuartzDocusaurus
技術基底Vite + Vue 3自建管線(TypeScript,UI 精簡、強調速度)React + webpack/MF 系工具鏈(v3 起內建 Swc)
文件側欄/目錄✅ 主題內建⚙️ Explorer 元件(樹狀導覽)✅ 側欄系統,自動生成
部落格⚙️ 自建(社区主題)✅ 文章即筆記✅ 內建(作者、RSS、標籤)
文件版本化(v1/v2 並存)❌❌✅ 招牌功能
多語言 i18n✅ 內建✅ 內建✅ 深度內建(CrowdIn 流程)
站內搜尋✅ 本機搜尋+Algolia DocSearch✅ FlexSearch 全文⚙️ 外掛(Local/Algolia/DocSearch)
雙向連結/反鏈❌✅ wikilink、Backlinks、Popovers❌
連結圖譜視覺化❌✅ 全站圖譜❌
Obsidian 相容([[wikilink]]、組件)❌✅ Obsidian-flavored MD❌
Mermaid/LaTeX⚙️ 生態(md 外掛)✅ 內建流水線⚙️ 外掛
MDX(JSX in Markdown)⚙️(Vue SFC 取代)❌(纯 MD 流水線)✅ 招牌
OpenAPI/API 文件⚙️ 社区方案❌⚙️ 外掛生態
主題自定義Vue 元件+themeConfigCSS 變數+佈局層JSON 主題設定+swizzle(免碰原始碼)
外掛生態小(Vue 生態補位)中(Quartz 插件管線)大(官方+社群外掛最多)
部署任意靜態託管GitHub Actions 一鍵內建 deploy presets(GH Pages 等)
全站 OG 圖/RSS⚙️ 外掛✅ 內建⚙️ 外掛
建置速度(大站感受)快(Vite 開發體驗極佳)最快級(v5 主打)中(功能多、冷啟動較重)
學習曲線低(會 Vue 就通)低(寫作導向,少寫設定)中(體系大、API 面廣)

維護模式與生態訊號

  • VitePress 掛在 vuejs 組織下,README 的贊助清單就是 Vite 生態全家福:VoidZero(Vite/Vitest/Rolldown/Oxc)、StackBlitz(線上 playground)、Algolia(DocSearch)、BrowserStack、Netlify。它的長期方向由 v2 alpha 主導—— Rolldown 化、更深的 Vite 整合。
  • Quartz 是這三者中唯一的「個人專案」,靠讚助手維持,議題數(72)與節奏顯示維護極勤。它的設計哲學是內容零建置負擔:push 到 GitHub 就發站,功能是內建開關而非外掛市場。
  • Docusaurus 由 Meta 出錢出人,README 明言「為了支撐 Meta 大量 OSS 專案而開源」;倉庫從 facebook 遷到 meta 組織也反映其歸屬。功能面它最「全套」:5 分鐘教學、npm init docusaurus@latest 一分鐘起站,docusaurus.new 瀏覽器秒開 playground。

適用場景

選 VitePress,當…

  • 你的專案是 Vue/Vite 系,文件站要能直接嵌互動元件(示範 demo、playground)。
  • 你要的是精簡文件站:侧欄+搜尋+深色模式+i18n 全部內建,不想碰主題工程。
  • 你享受 Vite 的開發體驗:改檔即時熱更新、配置寫在 config.mts 有型別提示。
  • 例:元件庫文件、SDK 指南、個人技術部落格(配社区主題)。

選 Quartz,當…

  • 你是筆記重度使用者(尤其 Obsidian),想把幾千則互相連結的筆記原樣發佈,連結關係不能斷。
  • 你要的是數位花園:圖譜、反鏈、hover 預覽、全文搜尋——這些在另外兩個都是外掛也湊不齊的體驗。
  • 你完全不想寫程式:改設定、丟 .md、git push,網站自己出現。
  • 例:個人知識庫、研究筆記公開版、Zettelkasten 入口站。

選 Docusaurus,當…

  • 你維護有版本概念的產品文件(v2 文件不能污染 v3 文件)——三家中獨有的版本化文件。
  • 你要多語言官方文件且有人分工翻譯(CrowdIn 流程完整)。
  • 你要專案官網整套:首頁+文件+部落格+行銷頁+MDX 互動区块,还要外掛生態(搜尋、PWA、表單、分析)。
  • 例:開源庫官方文件(React Native、Supabase 等級的站點都是這系)、公司開發者入口。

常見誤區

  1. 拿 Quartz 當文件站:沒有版本化、沒有 sidebars 語意、搜尋是筆記向——它是知識網,不是產品文件。
  2. 拿 VitePress 做多語言大型文件平台:i18n 有,但翻譯流程、版本化、MDX 生態都薄;超過一定規模會開始自己造輪子。
  3. 低估 Quartz 的定制度:v5 是整條管線重寫,功能開關+插件管線比 v4 彈性得多,「個人專案=停滯」是錯覺。
  4. VitePress 用 v2 alpha 上生產:alpha.21 仍會破壞 API,生產站點建議 v1.x,alpha 留給 Vite 生態追新者。
  5. Docusaurus 冷啟動慢=專案沒落:v3 的建置重量是「功能全內建」的代價;發佈節奏(v3.10.x 穩定推)與議題處理都很健康。

一句總結

文件要版本化、站點要成套 → Docusaurus;Vue 生態的精緻文件站 → VitePress;筆記的雙向連結要原樣上網 → Quartz。

Star history 三案對照

方法說明

星數、fork、授權、議題數、最新版本與 push 時間以 GitHub API 於 2026-11-16 驗證(VitePress 18,491/Quartz 13,596/Docusaurus 66,747);功能矩陣整理自三案官方文件與 README(vitepress.dev、quartz.jzhao.xyz、docusaurus.io);star-history 為即時熱鏈圖表。相關單案深度文章見 Crucible、Stela。