把微信读书笔记同步到 Notion

配置 Integration Token 与 Database ID,把划线与想法整理进结构化数据库

为什么把微信读书笔记同步到 Notion

微信读书是很多人每天都会打开的阅读应用,但里面的划线高亮和个人想法被锁在应用内部:只能逐条复制,没有批量导出,更没法和你的其他知识资产连起来。把微信读书笔记同步到 Notion 之后,这些散落在阅读应用里的思考切片,就变成了可以检索、可以关联、可以长期沉淀的数据库记录。

Notion 的优势在于结构化。比起一段纯文本,数据库里的「书名 / 作者 / 划线条数 / 想法条数」能让你一眼看出哪本书读得最认真、哪本书想法最多;而每本书独立的页面正文,又能完整保留按章节排列的原文引用与你的评注。当你想复盘某段时间的阅读,或把某一类主题的书串起来时,这种结构比在微信读书里翻书架高效得多。

ReadRelay 做的就是把这件事自动化:你只需要在 Notion 里建好数据库、关联一次 Integration,之后每次同步都是无感的。它不抓取书籍正文,只读取你自己的划线原文与想法,并直连 Notion 官方接口写入,中间不经过任何服务器。

同步后 Notion 里是什么结构

先看清楚「微信读书笔记导入 Notion」之后,数据库和页面到底长什么样,配置时就不会出错。目标数据库需要四个属性,名称和类型必须完全一致,否则创建记录会失败:

属性名 类型 写入内容
Book 标题(Title) 记录标题即书名
Author 文本(Text) 作者名
Highlights 数字(Number) 该书划线条数
Notes 数字(Number) 该书想法条数

每本书在数据库里生成一条页面记录,书名为记录标题。页面正文的排布规则是固定的:按章节追加二级标题(heading_2),每条划线写成一个引用块(quote),如果这条划线还附带了你的想法,就在引用块之后追加一个正文段落,内容以 📝 开头。整体结构可以用下面这段代码直观表示:

数据库属性(名称与类型必须一致):
  Book      标题类型   记录标题 = 书名
  Author    文本类型   作者名
  Highlights 数字类型  该书划线条数
  Notes     数字类型  该书想法条数

页面正文(按章节):
  H2  第一章 章节标题
    > 划线原文(quote 引用块)
    📝 我的想法(正文段落,以 📝 开头)
    > 另一条划线原文
  H2  第二章 章节标题
    > 划线原文
    📝 我的想法

也就是说,数据库的四个属性负责「概览与统计」,页面正文负责「完整内容」。在数据库视图里你看到的是每本书一行、带计数;点开任意一行,看到的才是按章节整理的原文引用与想法。

三步完成微信读书到 Notion 的配置

在 Notion 里准备一次,就能长期使用。配置路径在 ReadRelay 内是:设置 → 同步目标设置 → Notion 二级页面,在这里填写 Integration Token 与 Database ID。Token 会保存在 iOS 钥匙串里,你可以随时在应用内清除后重新填写。前置条件缺一不可,下面三步对应三个动作。

创建 Notion Integration 并复制 Token

打开 Notion,新建一个 Integration(内部集成),给它起一个能识别的名字。创建完成后,页面会给出一段 Integration Token,把它完整复制下来。回到 ReadRelay 的「设置 → 同步目标设置 → Notion」二级页面,把这段 Token 粘贴进 Integration Token 输入框。

获取微信读书笔记导入 Notion 所需的 Database ID

打开你准备用来接收笔记的目标数据库页面,复制浏览器地址栏里的 URL。Database ID 就藏在 URL 中:通常是 notion.so/工作区名/<Database ID>?v=... 这一段里那一长串 32 位十六进制字符。把它粘贴进 ReadRelay 的 Database ID 输入框。请注意这个 ID 必须来自数据库页面本身,而不是某个普通页面。

在数据库 Connections 中关联 Integration

进入目标数据库页面,点击右上角的 ··· 菜单,选择 Connections,把上一步创建好的 Integration 关联进来。这一步极易遗漏:如果数据库没有关联 Integration,Notion 接口会直接返回无权限错误,即使 Token 与 Database ID 都填对了也无法写入。

三步都完成、且数据库属性名称与类型正确后,就可以在 ReadRelay 里选中这本书执行同步了。首次同步会自动在该数据库创建记录并写入正文。

常见失败原因与排查

大部分同步失败都集中在权限、ID 与属性三处。下面按出现频率列出排查方向。

无权限

接口返回 401 / 无权限

几乎都是数据库没有关联 Integration 导致的。检查目标数据库页面右上角 ···Connections 是否已加入你的 Integration;同时确认 ReadRelay 里填的 Token 与这个 Integration 是同一个。

找不到数据库

接口返回 404 / 找不到数据库

通常是 Database ID 复制错了:确认它来自数据库页面 URL,而不是某个子页面或工作区首页;还要注意 ID 是否来自当前 Integration 所属的工作区,跨工作区会查不到。

创建记录失败

属性名称或类型不匹配

Book / Author / Highlights / Notes 这四个属性的名称和类型必须完全一致,改了名字或把数字改成文本都会导致创建记录失败。请逐项核对:Book 是标题类型,Author 是文本,Highlights 与 Notes 是数字。

分批写入

内容很多但没有报错

这不是故障。单次请求最多提交 90 个内容块,一本书笔记较多时,ReadRelay 会自动分多批提交。如果页面看起来只写了一部分,稍等片刻或重新同步即可补齐。

常见问题

微信读书笔记可以同步到 Notion 吗?

可以。在 ReadRelay 的「设置 → 同步目标设置 → Notion」二级页面填写 Integration Token 与 Database ID,即可把微信读书的划线与想法同步到指定的 Notion 数据库。每本书在数据库里生成一条页面记录,书名为记录标题,正文按章节整理引用与想法。

目标数据库需要提前建哪些属性?

需要四个属性,名称与类型必须完全一致,否则创建记录会失败:Book(标题类型,记录标题即书名)、Author(文本类型,填作者)、Highlights(数字类型,写入该书划线条数)、Notes(数字类型,写入该书想法条数)。其余属性可留空或自行扩展,但这四个不能改名或改类型。

同步后每本书在 Notion 里生成几条记录?

每本书只生成一条数据库记录,记录标题就是书名。页面正文则按章节追加二级标题(heading_2),每条划线写成一个引用块(quote),如果该条划线附带了你的想法,会在引用块之后追加一个正文段落,内容以 📝 开头。

Notion 同步提示无权限或找不到数据库怎么办?

最常见的原因是目标数据库没有关联你的 Integration。请在数据库页面右上角 ··· 菜单中选择 Connections,把创建好的 Integration 关联进来;同时要确认填写的 Database ID 确实来自这个数据库页面,且 Integration Token 完整无误。Token 保存在 iOS 钥匙串,可随时在应用内清除后重填。

重复同步会不会在 Notion 里产生重复内容?

不会。ReadRelay 会记录每本书已同步的页面 ID,再次同步时先清空该页面的全部子块再重新写入,因此不会累积重复内容。单次请求最多提交 90 个内容块,若一本书的笔记较多,应用会自动分批提交。

相关页面

如果你还想了解其他同步目标,或需要更通用的配置与排查说明,可以接着看:

把读过的书,接进你的 Notion

ReadRelay 已在 App Store 上架。下载后用微信读书账号完成一次授权,按上面的三步关联 Notion,即可把书架、划线与想法自动整理进数据库。

iOS 27 或更高版本 · iPhone 与 iPad 通用