主流框架概览
选型时先想清“内容规模、是否要版本化/多语言、团队技术栈、部署平台”，再看框架特性。
VitePress
- 基于 Vite + Vue 3，轻量、极快热更新。
- Markdown/MDX，侧边栏/导航配置简单。
- 适合：Vue 生态、轻量文档/博客、无需复杂插件。
Docusaurus
- React 生态，内置版本化、多语言、博客与文档双模。
- 插件/主题丰富，官方默认主题即开箱可用。
- 适合：大型文档站、需要版本化/多语言的产品/SDK。
Astro
- 内容优先，静态输出，按需岛屿交互。
- 可混用多框架组件（Vue/React/Svelte），适合同时托管文档与交互 Demo。
- 适合：重视性能与 SEO，同时需要少量交互或多框架共存。
MkDocs (+ Material)
- Python 生态，配置简单，配合 Material 主题体验好。
- 适合：后端/数据团队、CI 写作流程、需要稳定成熟的搜索/导航。
其他
- Next.js/NUXT Content：若团队已深度 React/Vue 且想统一技术栈，也可用通用 SSG/ISR 方案构建文档，但维护成本略高。