微信读书笔记一键同步到 flomo
下面按「为什么值得做 → 卡片长什么样 → 怎么三步配好 → 标签与频率怎么处理 → 常见问题」的顺序说明,全部基于 ReadRelay 对 flomo 目标的真实实现。
为什么把微信读书笔记同步到 flomo
微信读书里的划线,是阅读时最即时的思考切片:一句戳中你的话、一段想反驳的论述、一个准备之后展开的念头。它们散落在书页之间,合上书就很容易被遗忘。把微信读书 flomo 连接起来,等于给这些碎片配了一个入口——每一条划线都会变成一张可检索、可关联的 MEMO 卡片,沉淀在你的 flomo 浮墨笔记里,而不是停留在阅读 App 的本地缓存中。
相比手动复制粘贴,自动同步的价值在于「持续」。一次读完一本书可能只有几十条划线,但一年下来就是上千条素材。ReadRelay 把这件事变成后台的一键动作:你只需要在微信读书里照常划线、照常写想法,剩下的导出与推送由应用完成。当你在 flomo 里回顾「#读书笔记」标签,看到的不是某本书的摘录,而是自己一整年的阅读脉络。
这也是微信读书 flomo 组合最舒服的地方:微信读书负责「读」,flomo 负责「收」,二者都不强迫你搭一套复杂系统,适合只想轻量记录、长期复盘的读者。
每条划线会变成什么样的一张卡片
同步时,每一条划线都会作为一张独立的 MEMO,通过 HTTP POST 提交到你的专属 Webhook,请求体是一个简单的 JSON:{"content": "..."}。卡片正文由 ReadRelay 按固定模板拼装,结构如下(这是真实生成的格式,#微信读书/书名 与 #读书笔记 两个标签会自动附加):
《书名》作者名 · 第一章 章节名
> 划线原文第一行
> 划线原文第二行
📝 想法:这里是我的个人想法
#微信读书/书名 #读书笔记
几个需要特别说明的细节:
- 第一行是书名与章节的归属信息;若该书作者为空,首行会写成
《书名》· 章节名,不再出现作者字段。 - 划线原文以引用块(每行前加
>)呈现,多行划线会逐行保留。 📝 想法:这一行只有在你对该条划线写了个人想法时才会出现;纯划线、无想法时,卡片里不会凭空多出这行。- 标签里的书名会做安全清洗:空格替换为下划线、
/替换为-、并去掉#,避免破坏 flomo 的标签解析。例如《人类简史:从动物到上帝》会变成#微信读书/人类简史-从动物到上帝。
这样的卡片在 flomo 里天然按书名聚合,又和「#读书笔记」这个总标签交叉,回顾时既可以从单本书看,也可以跨越所有书看。
三步完成配置
微信读书划线导出 flomo 的整个配置过程不需要开发者账号,也不需要写任何代码。按下面三步即可:
获取 Webhook
打开 flomo 网页版或 App,进入「API / Webhook」入口,复制你的专属 Webhook 地址。这个地址就是 flomo 接收 MEMO 的入口,形如一段带随机令牌的链接,请整段复制、不要遗漏。
粘贴保存
在 ReadRelay 中进入「设置 → 同步目标设置 → flomo 浮墨笔记」二级页,把刚复制的 Webhook 地址粘贴进去并保存。该链接只保存在 iOS 钥匙串中,可随时在设置页清除,卸载应用也会一并移除。
选择目标并同步
在同步目标中开启 flomo 开关,回到书架选择想导出的书,按书同步或一键批量推送。应用会逐条把划线推送到你的 Webhook,每条生成一张 MEMO 卡片。注意:flomo 目标不需要微信读书以外的任何 Token,只需这一个 Webhook 链接。
标签、频率与失败排查
下面几个点关系到同步结果是否符合预期,建议配置前先了解。
自动标签怎么来的
每张卡片都会附加 #微信读书/书名 与 #读书笔记 两个标签。书名会做安全清洗:空格替换为下划线、/ 替换为 -、并去掉 #,保证 flomo 能正确识别,不会因特殊字符而拆成错误的标签。
为什么同步会偏慢
flomo Webhook 的限流约为 100 次 / 10 分钟。ReadRelay 在每张 MEMO 之间主动间隔 250 毫秒来规避限流,所以笔记很多时整批同步会慢一些。这是有意为之的保护,目的是不丢数据,请耐心等待完成。
返回错误如何定位
服务端返回 {"code": 0, "message": "success"} 视为成功;当 code 非 0 时,应用会把返回的 message 作为错误提示展示。先确认 Webhook 地址完整、未失效,再按提示中的 message 内容定位原因。
提交的是什么内容
每张 MEMO 以 HTTP POST 提交到你的 Webhook,请求体为 {"content": "..."},其中 content 即上文展示的卡片正文。flomo 只接收一个 content 字段,结构保持最小,便于稳定解析。
常见问题
微信读书 flomo 的 Webhook 在哪里获取?
在 flomo 网页版或 App 的「API / Webhook」入口可以获取你的专属 Webhook 地址。复制该地址后,在 ReadRelay 中前往「设置 → 同步目标设置 → flomo 浮墨笔记」二级页粘贴保存即可。Webhook 链接只保存在 iOS 钥匙串中,可随时在设置页清除。
微信读书划线导出 flomo 需要额外 Token 吗?
不需要。flomo 目标只依赖这一个 Webhook 地址,不要求你提供微信读书以外的任何 Token 或密钥。只要 Webhook 有效,ReadRelay 就能把划线推送为 MEMO 卡片。
每条划线和想法会变成几张卡片?标签怎么生成?
每条划线都会作为一张独立的 MEMO 卡片推送。卡片内容包含书名作者、章节名、划线原文引用、个人想法(仅在该条划线带想法时出现),以及自动附加的 #微信读书/书名 与 #读书笔记 标签。书名会做安全清洗:空格替换为下划线、正斜杠替换为短横线、并去掉井号。
同步很慢或提示被限流怎么办?
flomo Webhook 的限流约为 100 次 / 10 分钟。ReadRelay 在每张 MEMO 之间主动间隔 250 毫秒来避免触发限流,所以笔记很多时整批同步会慢一些,这是有意为之的保护,不会丢数据。请耐心等待同步完成;若中途打断,可再次同步,已写入的卡片不会重复生成。
返回错误提示应该怎么排查?
同步时每张 MEMO 以 HTTP POST 提交到你的 Webhook,请求体为 {"content": "..."}. 服务端返回 {"code": 0, "message": "success"} 视为成功;当 code 非 0 时,应用会把 message 作为错误提示展示。请先确认 Webhook 地址完整无误、未失效,再按提示中的 message 内容定位原因。
相关页面
如果你还想了解其它同步目标或整体用法,可以参考以下页面:
- ReadRelay 首页:了解全部同步目标与核心能力。
- 同步目标总览:查看 Obsidian、Notion、flomo、Markdown 四种目标的对比。
- 支持与常见问题:密钥配置、同步失败与各目标的排查说明。
- 微信读书同步到 Obsidian:单书单档写入 Vault 的指南。
- 微信读书同步到 Notion:结构化数据库写入指南。
- 微信读书导出 Markdown:本地标准 Markdown 文件导出指南。
把每一条划线,收进 flomo
ReadRelay 已在 App Store 上架。下载后用微信读书账号完成授权,粘贴一次 flomo Webhook,即可把书架里的划线与想法逐条推送为 MEMO 卡片。