Notion 博客 http://preview.tangly1024.com/ 一个NotionNext搭建的博客 Mon, 17 Aug 2026 09:47:12 GMT https://validator.w3.org/feed/docs/rss2.html https://github.com/jpmonette/feed en-US All rights reserved 2026, NotionNext <![CDATA[NotionNext 配置教程（示例）]]> http://preview.tangly1024.com/article/notionnext-config-guide http://preview.tangly1024.com/article/notionnext-config-guide Mon, 17 Aug 2026 00:00:00 GMT
💡
本文是博客配置示例。配置前请先确认项目已使用正确的 Notion 数据库。

配置方式与优先级

NotionNext 的配置通常来自以下位置：
  1. 项目中的 blog.config.js
  1. 所用主题的 config.js
  1. Vercel 环境变量
  1. Notion 内的「配置中心」
配置中心的优先级最高：其中已启用的配置会覆盖 Vercel 环境变量和 blog.config.js 中的同名配置。

使用配置中心

配置中心仅在 NotionNext V4.1.0 及以后版本支持。
  1. 打开博客数据库中的「配置中心」页面。
  1. 在 CONFIG-TABLE 新建或编辑一行配置。
  1. 勾选「启用」；未启用的行不会生效。
  1. 填写配置名与配置值。
  1. 部署后检查博客页面是否按预期更新。

配置表字段

字段
用途
启用
控制该配置是否生效
配置名
配置变量名，例如 AUTHOR
配置值
实际取值，例如作者名、true 或 false
配置备注
用于记录该配置的目的或修改原因
配置附件
当配置值为图片时，在此上传图片文件

注意事项

  • 可用的配置名和值，请以 blog.config.js 与当前主题的 config.js 为准。
  • 并非所有配置都支持写入配置中心；例如 NOTION_PAGE_ID 不支持在此设置。
  • 不要修改配置表的表头，除非你同时清楚项目中对应字段的实现。
  • 重要配置修改后，建议保留备注，方便之后排查。

发布前检查

配置项已勾选「启用」
配置名与项目配置文件完全一致
配置值符合预期格式
已确认没有用配置中心意外覆盖环境变量
已重新部署并在网页端验证
参考：
🔧
配置中心
项目仓库：NotionNext
]]> <![CDATA[模板说明]]> http://preview.tangly1024.com/article/guide http://preview.tangly1024.com/article/guide Fri, 02 Jul 2021 00:00:00 GMT

如何使用Notion编写文章

请访问教程获取帮助
如何在Notion中开始写作 | NotionNext文档
这是一个由NotionNext生成的站点
如何在Notion中开始写作 | NotionNext文档
https://docs.tangly1024.com/article/start-to-write
Notion快捷键 | NotionNext文档
Notion有很多使用的快捷键，看完这篇文章，让你的效率加倍
Notion快捷键 | NotionNext文档
https://docs.tangly1024.com/article/notion-short-key
Notion快捷键 | NotionNext文档

模板使用说明

NotionNext项目必须绑定一个Notion数据库才能使用。请访问教程获取帮助
Vercel云部署 | NotionNext文档
Vercel是一款国外的Serverless托管平台，对个人用户使用几乎免费，而且方便快捷，用Vercel托管你的Notion站点，无需再操心服务器的维护与资费问题。
Vercel云部署 | NotionNext文档
https://docs.tangly1024.com/article/vercel-deploy-notion-next#3df829414795492bb41ec351eb6da84e
Vercel云部署 | NotionNext文档

模板字段说

Notion数据库中，每条数据都将有以下属性🤔：
属性
必填
说明
备注
title
是
文章标题
ㅤ
status
是
发布状态
（仅当状态为Published 时会被 展示）
type
是
页面类型 (博文Post / 单页(Page)
单页不会在博文列表显示 。
summary
否
内容摘要
搜索和简略显示会用到，在文章列表会显示出
date
否
发布日期
在V3.3.9之前的版本此项为必填。
category
否
文章分类
可以自定义
tags
否
文章标签
可多个，建议不要太多
slug
否
文章短路径
(每篇文章唯一，请勿 重复）
icon
否
菜单栏图标(仅当Page/Menu类型有效)
可以参考：图标库地址
password
否
文章加锁
需要输入密码才允许访问
数据库的每一列有不同的功能； type： 这条数据的类型 ，有 notice(公告)、post(文章)、page(单页)、menu(菜单)、submenu(子菜单)这几种类型。 slug ，根据数据类型，有不同的作用：
  1. 在菜单(Menu\SubMenu)中表示跳转到哪个页面， 在文章中表示这篇文章在博客中的访问地址、也可以是外链。通常以左斜杆开头： /test-menu对应访问 → https://站点域名/testmenu。也可以设置成完整的外链，例如https://tangly1024.com 。
  1. 在单页中（Page）, 表示这个页面在站点根目录的文件名。不要以左斜杆开头: 例如 test-page → 对应 https://站点域名/test-page。
  1. 在博文中(Post)，也表示文件路径，但是博文会自动添加一个前缀。例如: test-post 则可以通过 https://域名/article/test-post 访问到这个博客，这里的article是默认配置的前缀。
]]> <![CDATA[EMPTY-ARTICLE]]> http://preview.tangly1024.com/article/example-3 http://preview.tangly1024.com/article/example-3 Fri, 02 Jul 2021 00:00:00 GMT
 
😀
这里写文章的前言： 一个简单的开头,简述这篇文章讨论的问题、目标、人物、背景是什么？并简述你给出的答案。
可以说说你的故事：阻碍、努力、结果成果，意外与转折。
 

📝 主旨内容

观点1

引用的话语

观点2

引用的话语

🤗 总结归纳

总结文章的内容

📎 参考文章

  • 一些引用
  • 引用文章
 
💡
有关Notion安装或者使用上的问题，欢迎您在底部评论区留言，一起交流~
]]> <![CDATA[绑定成功测试]]> http://preview.tangly1024.com/article/example-4 http://preview.tangly1024.com/article/example-4 Fri, 02 Jul 2021 00:00:00 GMT
😀
如果您的Notion数据库已经修改了内容，发现网站内容还是旧的，说明绑定NotionPageID失败了，请重新检查Vercel后台是否正确配置好ID，并尝试重新部署
]]> <![CDATA[示例文章]]> http://preview.tangly1024.com/article/example-1 http://preview.tangly1024.com/article/example-1 Mon, 20 Jan 2025 00:00:00 GMT

基本段落

书中自有黄金屋，书中自有颜如玉
💡
生活的意义并不是与他人争高下，而在于享受努力实现目标的过程，结果只是对自己行动的嘉奖。

将进酒

李白〔唐代〕参考[1]
君不见黄河之水天上来，奔流到海不复回。 君不见高堂明镜悲白发，朝如青丝暮成雪。 人生得意须尽欢，莫使金樽空对月。 天生我材必有用，千金散尽还复来。 烹羊宰牛且为乐，会须一饮三百杯。 岑夫子，丹丘生，将进酒，杯莫停。 与君歌一曲，请君为我倾耳听。 钟鼓馔玉不足贵，但愿长醉不愿醒。 古来圣贤皆寂寞，惟有饮者留其名。 陈王昔时宴平乐，斗酒十千恣欢谑。 主人何为言少钱，径须沽取对君酌。 五花马、千金裘，呼儿将出换美酒，与尔同销万古愁。
TANGLY's BLOG | 记录思考、分享我的学习笔记
记录思考、分享我的学习笔记
TANGLY's BLOG | 记录思考、分享我的学习笔记
https://tangly1024.com/
TANGLY's BLOG | 记录思考、分享我的学习笔记

特殊段落

1.代码

其他更多语言

2.公式

  • 数学公式
  • 化学方程
其他更多公式
 

3. 图表

4.下载附件

下载PDF附件.pdf
469.5KB
下载PDF附件-2.pdf
469.5KB

5. 照片集

💡
这是一张图片
notion image
照片集
照片标题1
照片标题1
照片标题2
照片标题2

6. 内嵌网页

7.内嵌视频

8.代办

家庭
洗衣
做饭
事业
开会
加班

9.折叠列表

点击展开
点击展开
点击展开
内容可以多级嵌套
 

10. 同步块

Notion支持将不同页面的块进行同步，即 SyncBlock，以下是来自另一个页面的块：
【sync-block】这是一段来自示例文章-3的段落 ，通过 SyncBlock同步。
💡
注意 ： 同步块的使用条件是源页面也要被开放共享 ，否则NotionNext将无权访问，页面上会被忽略渲染。
notion image
 

11.多级目录

heading标题在博客中自动转为目录

二级目录1

二级内容 1

二级目录2

二级内容2

二级目录3

三级目录3.1

不同级别的heading代表不同级别的目录

三级目录3.2

高一级目录嵌套低一级目录

多级列表

  • 事物的必然性
  1. 事物按规律变化，也有一种不可避免的性质．这种性质就叫做必然性
    1. 事物的必然性，是事物本身的性质（我们反对宿命论的是其认为这一切是受神明的支配，而不是反对事物发展中存在的不可避免的性质的事实）
      1. 第三级别列表
      2. 第三级别列表
    2. 其决定于它自己本身发展的情况和周围的条件
      1. 第三级别列表
        1. 第三级别列表

模板使用说明

若要部署你的NotionNext项目，请复制该模板，并按照模板格式创建文章：
Notion 博客 | Notion
一个NotionNext搭建的博客
Notion 博客 | Notion
https://tanghh.notion.site/02ab3b8678004aa69e9e415905ef32a5?v=b7eb215720224ca5827bfaa5ef82cf2d
Notion 博客 | Notion
Notion Blog - EN | Notion
NotionNext Blog
Notion Blog - EN | Notion
https://www.notion.so/tanghh/7c1d570661754c8fbc568e00a01fd70e?v=8c801924de3840b3814aea6f13c8484f&pvs=4
Notion Blog - EN | Notion
Notion页面中，每篇文章都将有以下属性🤔：
属性
必填
说明
备注
title
是
文章标题
ㅤ
status
是
发布状态
（仅当状态为Published 时会被 展示）
type
是
页面类型 (博文Post / 单页(Page)
单页不会在博文列表显示 。
summary
否
内容摘要
搜索和简略显示会用到
date
否
发布日期
在V3.3.9之前的版本此项为必填。
category
否
文章分类
可以自定义
tags
否
文章标签
可多个，建议不要太多
slug
否
文章短路径
(每篇文章唯一，请勿 重复）
icon
否
菜单栏图标(仅当Page类型有效)
可以参考：图标库地址
password
否
文章加锁
需要输入密码才允许访问

评论插件

系统支持 Waline\Giscus\Valine\GitTalk\Utterance\Cusdis\Twikoo六种评论插件，并且可以同时开启，点击评论区的Tab来体验。
按照以下教程可以开启响应的评论插件
NotionNext配置评论插件Twikoo | TANGLY's BLOG
一个简洁、安全、免费的静态网站评论系统，基于 腾讯云开发 。 经评论区网友推荐，我开始使用 Twikoo，一番体验，发现Twikoo真的很强大，目前我决定用它作为主要评论插件。 twikoo支持在页面上直接管理评论、配置插件，非常强大 在最新版本中 NotionNext已经 支持该评论插件，配置 方法很简单： 在Vercel后台添加一个环境变量 NEXT_PUBLIC_COMMENT_ENV_ID ; 值为您部署好的 twikoo 后台地址。以我的举例： 借助vercel，您可以非常快速地部署自己的twikoo后台，用于储存评论数据。 twikoo的后台数据存储是基于MongoDB数据库的，我们可以先注册创建一个免费的在线MongoDB数据库。 创建MongoDB数据库 1.注册账号 创建数据库 这里下方要设置一个允许访问该数据库的IP地址，推荐设置0.0.0.0，即所有地址都允许访问，毕竟我也不知道自己会用什么ip访问这个数据库。 2.获取数据库连接地址 Vercel一键部署 点击Create将twikoo的代码拷入您的仓库 配置MongoDB数据库地址 添加一个配置 MONGODB_URI 环境变量即可，其值为上一步获得的MongoDB连接地址，注意将链接中MONGODB的密码 替换成您设置的。 上述部署完成后，您将获得一个vercel的twikoo后台页面，您可以选择像我一样映射成二级域名 将您的twikoo后台地址配置在NotionNext的后台，并redeploy即可。 到此完成~ 点击右下角的小齿轮即可配置您的管理员密码、并进行更多的功能设置。赶快体验吧~ 可以访问官方文档获取安装部署帮助，并且查看Twikoo的更多特性。 NotionNext支持多种评论插件，可访问以下文章获得帮助：
NotionNext配置评论插件Twikoo | TANGLY's BLOG
https://tangly1024.com/article/notionnext-twikoo
NotionNext配置评论插件Twikoo | TANGLY's BLOG
NotionNext如何添加评论插件 | TANGLY's BLOG
NotionNext支持多种评论插件，其中体验比较好的我个人觉得是Twikoo，您可以参考以下教程进行配置安装： 您也可以选择Valine/Waline，关于Valine/Waline的部署可以访问此篇文章： Utterance 、 Giscus 、Gitalk 其中部署最便捷的当属 Cusdis 和 Utterance 这两个插件。您可以任选一个部署，当然，您也可以选择同时部署多个。 完成效果预览 点击Start for free ，并用Github登录即可 Sign in With Github (点击查看截图) [可选] 配置邮件通知地址，以便收到新评论时邮件通知您，（点击展开截图） 点击Embed Code获取您的应用ID，即data-app-id, 复制这串id备用。 在Vercel后台添加一个环境变量 NEXT_PUBLIC_COMMENT_CUSDIS_APP_ID，值为上面获取到的data-app-id。 完成预览效果 在您的Github中创建一个开源项目用于存放评论 在github中安装utterance插件 允许utterance访问所有仓库，并勾选install，可以只勾选作为评论用的仓库地址。 将用作评论仓库名添加到Vercel添加环境变量 后台 settings→ environment variables → 添加 → save 即可。如下图： 注意， 仓库名的格式是 [您的用户名/您的仓库名] 如下示例 完成预览效果 在您的Github中创建一个开源项目用于存放评论 创建一个授权秘钥，并保存您的ClientID与ClientSecret Authorization callback URL 填写您网站域名 填写配置的效果 ，点击 register application 即可创建。 点击 Generate a new client secret 生成您的密码 复制 Client ID和刚生成的 Client secret （对应图中2和3）备用。 在Vercel后台配置环境变量 NEXT_PUBLIC_COMMENT_GITALK_CLIENT_ID NEXT_PUBLIC_COMMENT_GITALK_CLIENT_SECRET NEXT_PUBLIC_COMMENT_GITALK_CLIENT_ID NEXT_PUBLIC_COMMENT_GITALK_CLIENT_SECRET 项目会在您的Github项目讨论区创建评论数据，便于维护管理 , 完成效果 预览 您可以在Github的Discusstion讨论区随时管理评论。 在您的Github中创建一个开源项目用于存放评论 在项目Setting中开启discussion功能 在Github中安装giscus应用 点击右上方的Install即可，并确认 允许访问仓库数据权限： 默认勾选All repositories即可。也可以只勾选用作评论的仓库，（后续还可以再回来配置） 访问Giscus填写并获取您的Giscus配置参数 主要配置输入您的仓库名，并选择 Discussion分类为 Announcements .
NotionNext如何添加评论插件 | TANGLY's BLOG
https://tangly1024.com/article/notion-next-comment-plugin
NotionNext如何添加评论插件 | TANGLY's BLOG
NotionNext配置Valine/Waline评论插件 | TANGLY's BLOG
Valine插件需要LeanCloud后端提供数据库存储功能，请按照以下步骤配置。 而Waline 的前置步骤和Valine基本一致，只是多了一个部署Waline的Vercel服务步骤。由于Waline配置了完善的后台管理功能，所以使用Waline就不需要再配合Admin-Valine项目运行。 应用创建好以后，进入刚刚创建的应用，选择左下角的 设置> 应用Key，然后就能看到你的 APP ID和 APP Key 了： 为了你的数据安全，请设置自己的 安全域名 ：只有以下设置的域名，才允许访问你的valine数据 支持的Valine配置在NotionNext项目的blog.config.js 中，请在Vercel后台的环境变量中配置： serverURLs在应用内部会尝试自动获取，如果发现获取失败，请手动提供 刚刚创建的应用，选择左下角的 设置> 应用Key，找到 Request 域名 第一行 需要在akismet中注册账号并获取免费的key： https://akismet.com/account ，并在LeanCloud中配置 AKISMET_KEY 变量 参考官方文档，在你的Vercel上部署一个valine应用。而后在你的NotionNext环境变量中添加你的waline服务地址环境变量： NEXT_PUBLIC_WALINE_SERVER_URL 即可生效。
NotionNext配置Valine/Waline评论插件 | TANGLY's BLOG
https://tangly1024.com/article/notionnext-valine
NotionNext配置Valine/Waline评论插件 | TANGLY's BLOG
 
测试嵌入PDF.pdf
469.5KB

引用文献

1. 关于李白

引用另一篇文章→
📖
模板说明
]]> <![CDATA[空白文章]]> http://preview.tangly1024.com/article/example-7 http://preview.tangly1024.com/article/example-7 Fri, 02 Jul 2021 00:00:00 GMT
type
Post
status
Published
date
Jul 2, 2021
slug
example-7
summary
仅供列表展示、文章无内容; 这里写文章的前言： 一个简单的开头,简述这篇文章讨论的问题、目标、人物、背景是什么？并简述你给出的答案。
tags
工具
category
技术分享
icon
password
😀
这里写文章的前言： 一个简单的开头,简述这篇文章讨论的问题、目标、人物、背景是什么？并简述你给出的答案。
可以说说你的故事：阻碍、努力、结果成果，意外与转折。
 

📝 主旨内容

观点1

引用的话语

观点2

引用的话语

🤗 总结归纳

总结文章的内容

📎 参考文章

  • 一些引用
  • 引用文章
 
💡
有关Notion安装或者使用上的问题，欢迎您在底部评论区留言，一起交流~
]]>