什么是文档框架
文档框架 = 文档专用的静态站点生成器,内置导航、侧边栏、搜索、版本化等特性。
文档框架
面向产品/技术文档的站点构建工具,通常以 Markdown/MDX 为内容源,负责生成带导航、目录、搜索、主题的静态网站。
核心特征
- 内容为中心:Markdown/MDX 写作,自动生成侧边栏/目录。
- 开发者体验:热更新、本地预览、支持自定义组件。
- 可扩展:插件/主题体系(如 Docusaurus 插件、VitePress 主题、Astro 集成)。
- 部署简单:产出静态文件,适合 CDN/边缘托管。
常见能力
- 全局导航、面包屑、侧边栏、搜索(本地/Algolia)。
- 版本化与多语言(Docusaurus 原生;其他可插件/配置实现)。
- 代码高亮、代码沙箱、Demo 嵌入、脚注/公式扩展。
- SEO 与性能:预渲染 HTML,支持 SSG/ISR/按需交互。
