用途:使用 Nextra + Next.js 构建专业文档站点,适合知识库、API 参考、多语言文档门户及带交互示例的技术文档。
主要能力:零配置 MDX(Markdown 与 JSX 混写)、基于文件系统的自动路由、代码分割与预取等性能优化、可插拔主题系统、内置 i18n 国际化、FlexSearch 高级搜索,以及通过 theme.config.tsx 定制品牌、侧边栏、目录与页脚。
核心文件:pages/ 存放 MDX 文档页,theme.config.tsx 为站点配置,_meta.js 控制导航结构与排序。
使用方式:初始化项目可运行 npx create-nextra-app@latest my-docs --template docs;在 theme.config.tsx 中配置 logo、project、docsRepositoryBase、sidebar、toc、footer、search 与 SEO 元数据;在 _meta.js 中定义侧边栏菜单与分隔符;在 MDX 中直接引入 React 组件(如 nextra/components 的 Callout)。部署可选 Vercel(npm install -g vercel 后执行 vercel)、GitHub Pages、Netlify 或自建服务器。
限制:资料未提供具体收费、价格与效果数据;版本历史显示 1.0.1(2025-11-23)与 1.0.0(2025-11-12),维护者为 alfred,领域为文档架构。