本技能用于使用 Nextra 与 Next.js 构建专业文档站点。核心优势包括:零配置 MDX(Markdown 与 JSX 无缝集成)、文件系统路由自动生成、代码分割与预取带来的性能优化、可插拔主题系统、内置国际化。
主要能力:覆盖 Nextra 3.x 与 4.x 架构模式,Next.js 14 与 15 集成配置,通过 theme.config.tsx 或 Layout 属性定制主题,FlexSearch 高级搜索,MDX 内容配合 React 组件,以及 4.x App Router 与 Turbopack 兼容。内置主题含 nextra-theme-docs(推荐文档站)与 nextra-theme-blog。
使用方式:用 npx create-nextra-app 指定 docs 模板初始化。项目含 pages 目录(含自定义 App 与首页 index MDX 及各栏目)与 _meta.json 导航配置。theme.config.tsx 导出配置对象,包含 logo、project、docsRepositoryBase 及 useNextSeoProps 等。_meta.js 文件控制侧边栏顺序与显示名,支持分隔线与外链。MDX 中可导入组件,nextra/components 提供 Callout。部署可选用 Vercel、GitHub Pages、Netlify 或自建服务器;Vercel 需全局安装 CLI 后运行 vercel 命令。
适用场景:构建现代 React 文档站、带高级搜索的知识库、多语言文档门户、自定义文档主题、在技术文档中嵌入交互示例。
限制:资料未提供收费、价格与具体效果信息。详细配置可参考 modules 目录下 configuration.md、mdx-components.md、i18n-setup.md、deployment.md。