NotionNext README

The project's README from github.com/notionnext-org/NotionNext. As one markdown file: README.md.

NotionNext Logo

NotionNext

用 Notion 搭建自己的独立站

继续在 Notion 写作,一键发布为博客、作品集、知识库、导航站或产品官网。

在线预览 · 开始搭建 · 主题全览 · 用户作品 · 文档站 · 讨论区

中文 | English


NotionNext 是什么?

NotionNext 是一个基于 Next.js + Notion API 的开源站点系统。你继续用 Notion 管理文章、分类、标签、菜单和页面,NotionNext 负责把这些内容发布成可访问、可搜索、可运营的独立网站。

它适合想长期沉淀内容的人:内容创作者、独立开发者、设计师、摄影师、课程作者、开源项目维护者,以及需要快速搭建产品官网或知识库的小团队。

你可以用它做什么?

目标 推荐入口 适合人群
搭个人博客 从这里开始 内容创作者、独立开发者、学生
做作品集或个人品牌站 按场景选主题 设计师、摄影师、自由职业者
做产品官网或 SaaS 落地页 Starter / Landing / Proxio 创业者、独立产品、小团队
做知识库或文档站 GitBook / Claude 开源项目、课程作者、团队文档
做导航站或资源聚合 Nav 主题 资源整理者、社群运营者

为什么选择 NotionNext?

20 分钟部署路线

  1. 打开 主题预览站 看最终效果。
  2. 复制 NotionNext 官方 Notion 模板。
  3. Fork 本仓库到自己的 GitHub 账号。
  4. 使用 Vercel 部署 NotionNext。
  5. 在环境变量中填写 Notion 页面 ID 等配置。
  6. 部署成功后,按场景选择主题并补齐域名、评论、统计、搜索等功能。

新手建议直接从文档站的 从这里开始 阅读。

主题与预览

场景 优先看
个人博客 simple、hexo、nobelium、typography
文档 / 知识库 gitbook、claude、thoughtlite
作品集 / 个人品牌 opc、proxio、starter、landing
产品官网 starter、landing、commerce
图片 / 摄影 photo、plog、magzine
导航站 nav

本地开发

推荐使用 Node 22 和 Yarn 1。Node 20 已无法安装当前依赖(@ai-sdk/google 要求 Node >=22),部署平台也需要同步设置为 Node 22。

# 1. 使用 Node 22
nvm use || nvm install

# 2. 安装 Yarn
npm i -g yarn

# 3. 安装依赖
yarn

# 4. 启动开发
yarn dev

常用命令:

命令 用途
yarn dev 启动本地开发
yarn build 构建生产版本
yarn export 静态导出
yarn docs:site:dev 本地预览文档站
yarn docs:site:build 构建文档站

文档入口

自 2026 年起,NotionNext 使用仓库内 Markdown 文档作为主要教程来源,并发布为独立文档站。

内容 链接
在线文档站 notionnext.tangly1024.com
新手入口 从这里开始
场景模板 按目标选择模板
配置索引 全站功能与配置索引
主题说明 26 个主题说明
用户作品 Showcase:已上线站点欢迎提交作品
文档源码 docs/
旧版手册 docs.tangly1024.com

参与社区

NotionNext 主仓库由 GitHub 组织 notionnext-org 维护。欢迎提交问题、补充文档、贡献主题、修复代码或参与讨论。

内容 链接
参与社区 community-participate.md
5.0 愿景与路线图 VISION_ROADMAP.md
贡献指南 CONTRIBUTING.zh-CN.md
项目治理 GOVERNANCE.zh-CN.md
维护者 MAINTAINERS.md
行为准则 CODE_OF_CONDUCT.md
讨论区 GitHub Discussions

如果你在仓库转让前已克隆旧地址,建议更新远程仓库:

git remote set-url origin https://github.com/notionnext-org/NotionNext.git
git remote -v

技术栈

相关项目

致谢

感谢 Craig Hart 发起的 Nobelium 项目。

Craig Hart
Craig Hart

感谢每一位参与代码、主题、文档、Issue、Review 与发布维护的贡献者。

Contributors

使用声明

本项目为免费、公开资源,仅限个人学习和合法站点建设使用。禁止利用本项目发布非法内容或进行违法活动。

License

The MIT License.

Project Stars

GitHub stars GitHub forks

Live star-history charts are temporarily unavailable because GitHub now restricts historical stargazer data to repository owners and collaborators.

NotionNext (notionnext-org/NotionNext)

Searching Database…

Что это такое?NotionNext — это система для сайтов с открытым исходным кодом, построенная на Next.js и Notion API: вы по-прежнему ведёте записи, категории, теги и меню в Notion, а она публикует это рабочее пространство как быстрый самостоятельный сайт с поиском.
Я и так могу делиться страницами Notion публично — что добавляет NotionNext?Публичная страница Notion — это просто документ. NotionNext превращает рабочее пространство в настоящий самостоятельный сайт с собственным доменом, SEO, sitemap, RSS, комментариями, аналитикой, поиском и подпиской по email — и рассчитан на долгосрочную работу.
Как опубликовать свой первый сайт?Скопируйте официальный шаблон NotionNext в Notion, сделайте форк этого репозитория в свой аккаунт GitHub, разверните его на Vercel и впишите ID своей страницы Notion в переменные окружения — README описывает это как путь на 20 минут.
Что нужно установить, чтобы запустить или доработать проект локально?Node 22 и Yarn 1. На Node 20 зависимости уже не установятся, потому что один пакет требует Node >=22, и платформа, куда вы развернёте сайт, тоже должна работать на Node 22. Дальше yarn dev для разработки, yarn build для продакшена или yarn export для статической сборки.
Если я соберу сайт так, не окажусь ли я привязан к Notion?Нет. Notion отвечает за контент, а сайт — за отображение и распространение, и в README сказано, что позже можно перейти на Markdown или другую систему.
Я не блогер — что ещё можно на этом построить?26 встроенных тем закрывают блоги, документацию и базы знаний, портфолио, сайты продуктов, фотогалереи, а также сайты-каталоги ссылок — для каждого сценария в README есть рекомендованные темы.
Какие темы стоит посмотреть в первую очередь?Для блогов начните с simple, hexo, nobelium или typography; для документации и баз знаний подойдут gitbook, claude или thoughtlite. opc, proxio, starter и landing годятся для портфолио и сайтов продуктов, photo и plog ориентированы на фотографию, а nav создаёт сайты-каталоги ссылок. Посмотреть и переключить темы можно онлайн на preview.tangly1024.com.
Почему лучше писать в Notion, а не в Markdown-файлах?Чтобы не переключаться между инструментами для письма: записи, категории, теги, обложки и меню остаются в Notion, а публикацией занимается NotionNext. Проект вырос из Nobelium Крейга Харта, который в README назван его прообразом.
Он работает где-нибудь ещё, кроме Vercel?Да. Zeabur указан в README как вариант развёртывания наряду с Vercel, в CI репозитория собирается Docker-образ, а yarn export даёт полностью статическую сборку, которую можно разместить на любом статическом сервере.
С какими сторонними сервисами он интегрируется?В README названы пять систем комментариев: Twikoo, Giscus, Gitalk, Cusdis и Utterances. В зависимостях также Algolia для поиска по сайту, Clerk для пользовательских аккаунтов, Supabase и Vercel Analytics.
Size
266.9 MB
Stars
11.9K
Age
5y
Commits · 90 Days