Skip to content

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 请求),大库需分批与退避
  • 富文本块结构复杂,写回时优先处理纯文本与简单块

相关阅读 ​