Notion API 进阶
相比一次性导入,用 Notion API 可做深度双向集成:把数据库记录拉进 Obsidian 编辑,再写回 Notion,保持单一事实源。
核心要点
配置 token
- 在 Notion Integrations 创建内部集成,获取 Integration Token
- 把目标页面/数据库「连接」到该集成,赋予读写权限
- 用社区插件(如
Notion类)或自建脚本,以 Token 调用 API 拉取/写入
双向同步策略
- 数据库每行 → 一篇笔记,frontmatter 映射属性,页面 ID 存
notionId - 在 Obsidian 修改后,脚本检测变更写回 Notion 对应字段
- 用
last_edited_time判断哪端较新,避免覆盖
注意事项
- Token 等同账号权限,存环境变量或插件私有配置,勿进 git
- Notion API 限流(每秒约 3 请求),大库需分批与退避
- 富文本块结构复杂,写回时优先处理纯文本与简单块