NotionNext 使用说明

Appearance

Notion 数据与 4.x 能力 ​

对应 conf/notion.config.js、lib/db/SiteDataApi.js · 版本 4.9.5.x

必需环境 ​

变量说明
NOTION_PAGE_ID站点根页 32 位 ID，可多语言用逗号分隔如 id,en:xxx
NOTION_TOKEN_V2非公开数据库时必填

数据库视图（NOTION_INDEX） ​

NOTION_INDEX（或 NEXT_PUBLIC_NOTION_INDEX）指定使用 Notion 数据库的第几个视图作为排序与列表来源：

  • 0 = 第一个视图（默认）
  • -1 = 最后一个视图

在 Notion 中调整视图排序后，需重新部署或等待 ISR 刷新。

字段名自定义 ​

NOTION_PROPERTY_NAME 可把英文表头改为中文，键包括：title、status、type、slug、category、tags、date、summary、password、icon、ext 等。详见 conf/notion.config.js。

内容类型（type） ​

type说明
Post博文，出现在列表
Page单页
Menu / SubMenu自定义导航，见 menu-secondary.md
Notice公告
Config配置中心表格

status 需为 Published（或你在配置里定义的发布值）才会展示。

定时发布 ​

POST_SCHEDULE_PUBLISH / NEXT_PUBLIC_NOTION_SCHEDULE_PUBLISH：按 Notion date 字段控制上下架。

文章密码 ​

支持 Notion password 字段；服务端校验使用 SHA256（兼容旧版 md5）。见仓库 lib 中文章锁相关实现。

单篇隐藏评论 ​

数据库增加 Select 属性 comment，值为 Hide 时隐藏该文评论区（4.5.4+）。

外部媒体嵌入 ​

Notion 中的视频/音频块会经 normalizeExternalMediaBlock 处理，包含 Apple Music 等嵌入 URL 的规范化，以便在文章中正确渲染。

全局置顶标签（TOP_TAG） ​

在 Config 或环境变量设置 TOP_TAG / NEXT_PUBLIC_TOP_TAG：

  • 带该标签的多篇「置顶」文章，会在置顶子集内按最近更新时间倒序
  • 不影响非置顶文章顺序

写作与模板 ​

升级注意（2026） ​

Notion API / 数据结构多次变更，请保持 NotionNext 与 latest 推荐版本一致，否则可能无法完整拉取页面。