用途
Docusaurus 用于构建现代文档网站，基于 React，可生成快速、对 SEO 友好的静态站点。该技能适用于以下场景：为开源项目编写文档；需要在文档中嵌入 React 组件；需要多版本文档；需要国际化文档；希望在文档之外同时提供博客功能；构建开发者门户；需要快速且 SEO 优化的静态站点；希望使用 MDX 编写交互式示例。
以下场景不建议使用：简单的单页文档（可使用基础 HTML）；Python 专用 API 文档与 autodoc（可使用 Sphinx）；没有 React 经验且需求简单（可使用 MkDocs）；需要实时协作编辑（可使用 GitBook）；制作幻灯片演示（可使用 Marp）。
主要能力
该技能覆盖的内容包括：项目搭建与配置、使用 MDX 编写文档页面、博客功能、侧边栏配置、主题定制、版本管理设置、国际化（i18n）、Algolia 搜索集成、GitHub Pages 部署，以及最佳实践与故障排查。
子技能涉及：项目结构、与 TypeDoc 的集成、文档结构、构建失败（Module Not Found）的排查、MDX 与 React 组件、Admonitions、版本管理、自定义首页等。
使用方式
安装与创建项目：
# Create new Docusaurus project
npx create-docusaurus@latest my-website classic
# With TypeScript
npx create-docusaurus@latest my-website classic --typescript
cd my-website
npm start
系统要求：Node.js 18.0 或更高版本；npm 8 或 yarn 1.22+；Git（用于版本管理功能）。
适用场景
适合需要 React 组件、多版本、国际化、博客与文档并存、开发者门户、SEO 优化静态站点以及 MDX 交互式示例的文档项目。
限制
不适合简单单页文档、Python 专用 API 文档（autodoc）、无 React 经验的简单需求、实时协作编辑以及幻灯片演示。
版本历史
v1.0.0（2026-01-17）：初始技能创建，包含项目搭建与配置、使用 MDX 的文档页面、博客功能、侧边栏配置、主题定制、版本管理设置、国际化（i18n）、Algolia 搜索集成、GitHub Pages 部署、最佳实践与故障排查。
暂未提供
该技能的收费、价格、平台支持范围、具体效果指标等事实暂未提供。