Docusaurus 中文站点

被 Redux、Supabase、Temporal、React Native 等知名项目用于官方文档的静态站点生成器，专注让团队把时间花在内容而非造轮子上。

它能做什么

Docusaurus 用 Markdown/MDX 写文档，自动生成静态 HTML，支持在 Markdown 中嵌入 React 组件。内置文档版本化、国际化（i18n）、Algolia 搜索、博客功能，并提供可插拔的插件架构。

• MDX 驱动: 在 Markdown 里直接写 JSX 和 React 组件，实现交互式文档
• 版本化: 为每个项目版本维护独立文档，与发行节奏同步
• i18n: 开箱支持多语言翻译，可配合 Git 或 Crowdin 工作流
• 搜索: 集成 Algolia 文档搜索，用户可快速定位内容
• React 扩展: 通过编写 React 组件自定义布局和主题，复用插件数据

适合谁用

开源项目维护者、技术团队、需要快速搭建文档站点的个人开发者。Prettier 首席开发者 Christopher Chedeau 称其让他不用每周重复造轮子；React Native 团队迁移后贡献量直线上升。

• 开源项目: Redux、Supabase、Temporal、IOTA 等均使用 Docusaurus 托管文档
• 技术团队: 支持 monorepo 工作区，侧边栏可自动生成，无需手动配置
• 个人博客: 也可用于个人网站、产品落地页等非文档场景

怎么上手

确保安装 Node.js 后，在终端执行 npx create-docusaurus@latest my-website classic 创建项目，再运行 npx docusaurus start 即可在 http://localhost:3000 看到站点并跟随内置教程学习。也可直接访问 docusaurus.new 在浏览器中在线体验。

• 5 分钟教程: 官网提供嵌入式交互教程，边玩边学
• 在线试用: docusaurus.new 无需安装，浏览器内直接创建站点
• 迁移支持: 官方提供从 v1 到 v2+ 的迁移指南，v1 已弃用

常见问题

Q1：Docusaurus 的版本化功能如何工作？

A1：可以为每个项目版本创建独立的文档集，例如 v1、v2、v3，用户可切换查看。版本化文档的发布与项目发行时间保持一致，避免新旧版本内容混淆。

Q2：Docusaurus 支持哪些部署平台？

A2：官方推荐 GitHub Pages、Netlify、Vercel 等静态托管服务。生成的 HTML 文件可直接部署，无需服务器端运行时。

Q3：Docusaurus 能否用于非文档类网站？

A3：可以。官网明确说明它可用于个人网站、产品页、博客、营销落地页等任何类型的静态站点，不限于文档。

更多同类工具与网站,可在构建工具分类继续挑选。

信息核实于 2026年7月,具体以官网为准。