一个使用 Next.js + Notion API 构建的高颜值静态博客系统
为 Notion 与所有创作者设计 ✨
自 2026 年起，站长向教程在仓库内维护，并发布为独立静态站：
| 在线阅读 | https://notionnext.tangly1024.com |
| 源码目录 | docs/（docs/README.md 含维护与部署说明） |
| 参与修改 | 文档页底部「在 GitHub 上维护此页」→ 编辑后合并 main 即自动部署 |
本地预览文档站：yarn docs:site:dev · 构建：yarn docs:site:build
- 在线文档站（推荐）：notionnext.tangly1024.com · 仓库目录 docs/user-guide/
- 4.9.x 参考手册：全站配置索引 · 25 个主题说明 · 本地预览文档站（
yarn docs:site:dev） - 文档维护工作流：docs/user-guide/MAINTENANCE_WORKFLOW.md（目录秩序、检查清单、注意事项）
- 维护策略：docs/DOCUMENTATION_POLICY.md
- 旧版手册：docs.tangly1024.com · slug 对照与迁移索引（重要章节已迁入
docs/user-guide/）
本项目为免费、公开资源，仅限个人学习使用，禁止利用本教程建立的博客发布非法内容、进行违法犯罪活动。
Notion是一个能让效率暴涨的生产力引擎，可以帮你书写文档、管理笔记，搭建知识库，甚至可以为你规划项目、时间管理、组织团队、提高生产力、还有当前最强大的AI技术加持。
中文文档 | README in English
一个使用 NextJS + Notion API 实现的，部署在 Vercel 上的静态博客系统。为Notion和所有创作者设计。
仓库托管： 主仓库现由 GitHub 组织 notionnext-org 维护（canonical：https://github.com/notionnext-org/NotionNext）。欢迎参与贡献并关注组织内协作说明；若在转让前已克隆本地仓库，建议执行 git remote set-url origin https://github.com/notionnext-org/NotionNext.git 后使用 git remote -v 确认。
支持多种部署方案
# 1) 使用 Node 20（建议先安装 nvm）
nvm use || nvm install
# 2) 安装 Yarn（若未安装）
npm i -g yarn
# 3) 安装依赖并启动开发
yarn
yarn dev常用命令：
- 本地开发：
yarn dev - 打包构建：
yarn build - 静态导出：
yarn export
说明：本地开发保持简单（yarn 即可）；锁文件一致性由 CI 严格校验。
项目由 notionnext-org 托管，欢迎站长与开发者共同维护。
| 参与指南 | docs/user-guide/community-participate.md（在线：参与社区） |
| 贡献代码/文档 | CONTRIBUTING.zh-CN.md |
| 项目治理 | GOVERNANCE.zh-CN.md · MAINTAINERS.md |
| 行为准则 | CODE_OF_CONDUCT.md |
| 维护者手册 | MAINTAINER_RUNBOOK |
| 讨论 | GitHub Discussions |
为方便新贡献者快速上手，项目已补充文档导航与协作规范：
- 在线切换主题：preview.tangly1024.com（左下角挂件）
- 25 个内置主题说明：docs/user-guide/themes/THEMES_CATALOG.md
- 想贡献新主题？见 CONTRIBUTING.zh-CN.md 与 主题迁移指南
感谢Craig Hart发起的Nobelium项目
 Craig Hart |
致敬每一位开发者！
- 框架: Next.js
- 样式: Tailwind CSS
- 渲染: React-notion-x
- 评论: Twikoo, Giscus, Gitalk, Cusdis, Utterances
- 图标: Fontawesome
- Elog Markdown 批量导出工具、开放式跨平台博客解决方案，随意组合写作平台(语雀/Notion/FlowUs/飞书)和博客平台(Hexo/Vitepress/Halo/Confluence/WordPress等)
The MIT License.
