nextra.site
Nextra官网截图
点击查看大图

Nextra基于Next.js开发,内置Markdown/MDX支持、全文搜索、多语言适配、主题定制等功能,开发者可快速搭建文档站点、个人博客、团队知识库,无需从零开发站点架构,专注内容创作,降低建站成本,已支持数千个站点的搭建与部署。

核心功能

文档生成
基于Next.js搭建,可快速将Markdown文件转化为美观的静态文档站点
主题切换
内置明暗两种主题,用户可自由切换,适配不同浏览习惯
搜索功能
自带全文搜索能力,输入关键词即可快速定位文档内容位置
导航配置
支持自定义侧边栏、顶部导航栏,按需调整站点内容结构
MDX支持
兼容MDX语法,可在文档中插入React组件实现交互效果
多语言配置
内置多语言适配方案,轻松搭建不同语言版本的文档站点
部署便捷
生成的静态文件可直接部署到Vercel、Netlify等常见托管平台
样式自定义
支持修改全局样式、组件样式,适配不同品牌的视觉需求

使用指南

  1. 1

    访问Nextra官方文档页面,下载初始化项目的基础模板代码包并解压到本地目录

  2. 2

    打开终端进入项目目录,执行npm install命令安装项目依赖包

  3. 3

    在项目content文件夹中创建markdown或mdx格式的内容文档,编写站点展示内容

  4. 4

    修改next.config.mjs配置文件,调整站点标题、导航菜单等基础站点参数

  5. 5

    执行npm run dev命令启动本地开发服务,预览站点实际展示效果

  6. 6

    根据预览结果调整主题配色、排版样式等自定义配置项

  7. 7

    完成调试后执行npm run build命令打包生产环境的静态站点文件

  8. 8

    将打包生成的out目录文件上传至支持静态站点部署的云服务平台

  9. 9

    完成域名解析配置后,即可正式上线搭建完成的文档或博客站点

优势亮点

使用须知

定价: Nextra本身是开源工具,所有核心功能都可以免费使用,没有付费版本限制。如果需要官方提供的定制开发、技术支持等服务,相关费用以官网为准。用户自己部署站点产生的服务器、托管等费用,由对应的服务提供商收取。

价格和授权政策可能变化,请以官网最新信息为准

访问第三方网站时,请注意以下事项:

  • 谨慎提供个人账号、密码和支付信息
  • 下载文件前确认来源安全,警惕诱导性广告
  • 涉及版权素材使用时,请核实授权范围
  • 如遇网站无法访问或内容异常,可反馈给我们

常见问题

基础的内容编写只需要会Markdown语法就行,但站点初始化、配置和部署需要有基础的前端知识,完全不懂代码的用户上手有难度。

可以,打包生成的是纯静态文件,只要是支持静态文件托管的服务器或者平台都可以部署,没有特殊限制。

可以,除了文档主题外也有博客主题可选,支持配置文章列表、标签分类等博客常用功能,自定义空间很大。

可以,只需要安装对应的依赖,修改next.config.js的配置,新增对应的文档页面路由即可,不会影响原有项目功能。

支持,直接把现有的.md或者.mdx文件放到对应的pages目录下,按照规则配置好导航就能正常显示。

深度了解

Nextra是基于Next.js开发的静态文档生成工具,主打快速搭建美观实用的文档站点,属于前端开发常用的效率工具。它支持Markdown和MDX两种语法,用户可以直接用熟悉的Markdown编写内容,也可以插入React组件实现交互效果,适合做开源项目文档、产品说明手册、内部知识库、个人技术博客等类型的站点。内置的明暗主题切换、全文搜索、多语言配置等功能,不用额外开发就能直接使用,能大幅减少站点搭建的时间成本。对于熟悉React和Next.js的开发者来说,上手门槛很低,默认的文档主题已经经过优化,不用额外调整样式就能达到不错的视觉效果,生成的静态站点加载速度快,对搜索引擎友好,部署也很方便,支持Vercel、Netlify、阿里云OSS等各类托管平台。不管是个人开发者给自己的项目写文档,还是技术团队搭建内部知识库,都可以用Nextra来完成,不需要从零开始开发文档站点,把更多精力放在内容创作上。

访问第三方网站时,请注意账号、隐私与支付安全