Aiko
1
以下是熱門 Docusaurus 主題的整理表格：
| 主題名稱 |
類型 |
說明 |
來源 |
| @docusaurus/theme-classic |
官方 / 核心 |
Docusaurus 預設經典主題，目前唯一正式達到 production-ready 的官方主題 |
npm / 官方 |
| @docusaurus/theme-live-codeblock |
官方 / 增強 |
提供即時程式碼區塊功能，可在文件中嵌入可互動的程式碼範例 |
npm / 官方 |
| @docusaurus/theme-search-algolia |
官方 / 搜尋 |
整合 Algolia 搜尋元件，為文件站提供全站搜尋功能 |
npm / 官方 |
| docusaurus-theme-openapi-docs |
社群 / API 文件 |
OpenAPI 主題，可自動從 OpenAPI 規格產生 API 文件頁面，由 Palo Alto Networks 維護 |
npm |
| docusaurus-theme-redoc |
社群 / API 文件 |
提供 Redoc 與 ApiDoc 元件，支援深色模式，與經典主題風格一致 |
npm |
| docusaurus-theme-search-typesense |
社群 / 搜尋 |
Typesense 搜尋元件，作為 Algolia 的替代方案 |
npm |
| @easyops-cn/docusaurus-search-local |
社群 / 搜尋 |
離線/本地搜尋外掛，可在防火牆後運作，不依賴外部服務 |
npm |
| docusaurus-theme-mdx-v2 |
社群 / 內容 |
為 Docusaurus 新增 MDX v2 支援，GitHub 28 stars |
GitHub |
| docusaurus-theme-zen |
社群 / 魔改 |
支援 LeetCode 同款組合程式碼區塊、.drawio.svg 編輯、嵌入 VS Code 編輯器、Giscus 評論 |
GitHub |
| @infinum/docusaurus-theme |
社群 / 設計 |
提供風格覆寫與新元件，用於建立一致的開源專案頁面 |
npm |
| Docusar |
社群 / 多用途 |
多用途主題，支援 JSON 資料驅動、深色/淺色模式、Widget 區塊結構，適用於新創、託管、代理商等網站 |
docusar.pages.dev |
| docusaurus-plugin-typedoc-api |
社群 / API |
由 TypeDoc 驅動的原始碼 API 文件產生器 |
npm |
| docusaurus-theme-brython |
社群 / 互動 |
在 Docusaurus v3 頁面中顯示可互動的 Python 程式碼片段，支援 Turtle Graphics |
GitHub |
大部分專案都以 @docusaurus/theme-classic 為基底，再搭配上方的增強主題來擴充功能。如果你是要為 Tenten 或 Neteon 的文件站選主題，classic + Algolia search + OpenAPI docs 的組合是最常見的生產級配置。
Aiko
2
截至 Docusaurus 3.9.2，官方可直接算「主 UI theme」的其實只有 @docusaurus/theme-classic 是 production-ready；其餘多半是增強型 theme，或社群模板／API docs 主題。下面這份表是目前最值得看的名單。 (Docusaurus)
| 排名 |
名稱 |
類型 |
適合用途 |
重點 |
| 1 |
@docusaurus/theme-classic |
官方主題 |
一般產品文件、技術文件、部落格 |
官方主題核心，支援 docs/blog/pages，也是目前唯一官方標示 production-ready 的主題。 (Docusaurus) |
| 2 |
docusaurus-tailwind-shadcn-template |
社群模板 |
想把 Docusaurus 做得更像現代 SaaS 文件站 |
整合 Tailwind CSS + shadcn/ui，支援 docs、API docs、blog；目前是最像「高質感新外觀 starter」的選項之一。 (GitHub) |
| 3 |
@docusaurus/theme-search-algolia |
官方增強 theme |
大型文件站搜尋 |
提供 @theme/SearchBar，可直接整合 Algolia DocSearch，和 classic theme 搭配最穩。 (Docusaurus) |
| 4 |
@easyops-cn/docusaurus-search-local |
社群 search theme/plugin |
不想依賴 Algolia、需要中文友善搜尋 |
支援 Docusaurus v2/v3，主打離線／本地搜尋，特別優化中文。 (GitHub) |
| 5 |
@docusaurus/theme-mermaid |
官方增強 theme |
架構圖、流程圖很多的文件站 |
內建 Mermaid 圖表能力，可在 Markdown code block 直接渲染圖表。 (Docusaurus) |
| 6 |
@docusaurus/theme-live-codeblock |
官方增強 theme |
教學型文件、互動式範例 |
提供由 React Live 驅動的互動式 CodeBlock。 (Docusaurus) |
| 7 |
docusaurus-openapi-docs |
社群 plugin + theme |
API reference 文件 |
可由 OpenAPI spec 產生 MDX，並搭配 docusaurus-theme-openapi-docs 產出互動式 API docs；目前仍在活躍更新。 (GitHub) |
| 8 |
redocusaurus |
社群 preset/theme |
想把 Redoc 風格嵌進 Docusaurus |
把 Redoc 包進 Docusaurus，支援暗色模式，適合偏 API 門戶型文件。 (GitHub) |
| 9 |
docusaurus-theme-search-typesense |
社群 search theme |
想用 Typesense 取代 Algolia |
是 theme-search-algolia 的客製 fork，改接 Typesense。 (GitHub) |
| 10 |
@markprompt/docusaurus-theme-search |
社群 AI search theme |
想做 AI/LLM 文件搜尋 |
提供 Docusaurus 專用的 Markprompt 搜尋 theme，偏 AI assistant 式搜尋體驗。 (GitHub) |
| 11 |
docusaurus-theme-github-codeblock |
社群 feature theme |
程式碼教學、SDK docs |
可直接引用 GitHub repo 的公開程式碼片段，支援 Docusaurus v2/v3。 (GitHub) |
| 12 |
docusaurus-material-ui-template |
社群模板 |
偏企業感、偏 MUI 設計系統 |
把 Material UI 整合進 Docusaurus，適合已有 MUI 設計語言的團隊。 (GitHub) |
直接結論
| 需求 |
最適合選項 |
| 最穩、最官方 |
@docusaurus/theme-classic (Docusaurus) |
| 想做得像現代 SaaS 文件站 |
docusaurus-tailwind-shadcn-template (GitHub) |
| 中文搜尋 |
@easyops-cn/docusaurus-search-local (GitHub) |
| API docs 最強 |
docusaurus-openapi-docs 或 redocusaurus (GitHub) |
| 互動教學 |
@docusaurus/theme-live-codeblock (Docusaurus) |
真正需要「外觀改很多」時，Docusaurus 生態不是靠大量現成 theme 取勝，而是靠 theme-classic + swizzle + Tailwind/shadcn 或 MUI 模板去改。官方文件目前也明講，主題生態還沒發展到可自由切換多套 production-ready UI 的程度。 (Docusaurus)