Nextra
基于 Next.js 的静态站点生成框架,用 Markdown 和 MDX 写作,文件系统路由自动生成页面,自带文档主题、Pagefind 全文搜索和多语言目录,适合熟悉 React 的开发者给开源项目维护多版本文档站。
最近 2 次实测
2 次可以打开平均 0.4 秒
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。Nextra 是一个建立在 Next.js 之上的静态站点生成框架,用 Markdown 和 MDX 写内容,最后生成一个完整的网站。它最常见的用途是给开源项目或产品做文档站:把 page.mdx 文件放进目录,路由就自动生成,不用手写导航配置。
它自带一套文档主题,侧边栏、目录、上一页下一页、搜索框都是现成的。页面里的 Markdown 链接和图片会被自动换成 Next.js 的 Link 和 Image 组件,跳转不刷新整页,图片也按需优化。代码块用 Shiki 在构建时做高亮,不拖慢浏览器。
主要功能
- 文件系统路由:目录结构就是站点结构,配
_meta.js调整顺序和标题。 - 零配置全文搜索:构建时自动索引内容,通过 Pagefind 提供搜索。
- 多语言:按
/en、/de这样的语言目录放文件即可,其余交给 Next.js。 - 内置组件:Callout、Cards、FileTree、Steps、Tabs 等,直接在 MDX 里调用。
- 深浅色模式、RTL 布局、无障碍支持(跟随系统的对比度和减弱动效设置)。
- 混合渲染:可以在 Markdown 内容里混用 Server Components、Client Components 和增量静态再生成。
适合谁
已经熟悉 React 和 Next.js 的开发者最顺手,尤其是要维护多版本文档、多语言文档的团队。只想写博客的人也能用它的博客主题,但需要接受 Node.js 工具链和构建流程,不是打开网页就能写的那种。
版本与限制
当前主版本是 Nextra 4.0,官方仍保留 v3 和 v2 的文档入口,从旧版迁移有专门的说明页。站点本身是英文界面,文档内容也以英文为主。作为开源项目,它没有付费版本,使用成本主要是学习和配置 Next.js 的时间。
常见问题
用 Nextra 要登录吗?
不用登录就能用。
Nextra 有哪些平台 / App?
支持 网页。
