把微信读书笔记同步到 Obsidian
本页说明如何用 ReadRelay 把微信读书的划线、高亮与想法同步到 Obsidian 仓库：从配置路径、文件落点、导出格式，到授权失效如何恢复，都是实际可用的操作信息。
为什么要把微信读书笔记同步到 Obsidian
很多人用微信读书做划线，但划线被锁在阅读应用里，既不好检索，也难以和自己的其他笔记打通。把微信读书的笔记同步到 Obsidian，等于把散落在书里的高亮与想法，统一收进你长期维护的知识库：可以全文搜索、可以按主题二次整理、也可以和你在 Obsidian 里写的读书卡片相互链接。当「微信读书 Obsidian」成为一种固定工作流后，读完一本书留下的不再是几十条被遗忘的划线，而是一份能够长期复用的 Markdown 笔记。
从实现定位上看，ReadRelay 是 iPhone / iPad 原生应用，通过微信读书官方开放服务的 API Key 授权，把笔记直接写入你选定的 Obsidian Vault 目录。整个过程不依赖桌面端、Node 环境或社区插件，由你的设备在本地完成文件写入——这意味着你可以在 iPhone 或 iPad 上独立操作，不需要开着电脑或额外的中间服务。对于已经习惯在手机上阅读、希望随时把笔记沉淀到 Obsidian 的用户来说，这种「原生、本地优先」的路径更轻、也更容易坚持。
此外，微信读书笔记导入 Obsidian 之后，文件是你自己的：它们以标准 Markdown 形式落在本机或 iCloud Drive 的 Vault 目录里，随时可以备份、迁移或用纯文本方式长期保存，不绑定任何云端账号体系。
微信读书同步 Obsidian 的具体效果
同步完成后，每本书会在 Vault 的 Books/ReadRelay/ 下生成一个 Markdown 文件。文件由统一的 Markdown 渲染器生成，结构清晰、可被 Obsidian 直接打开。下面是真实导出格式的示例（书名为占位示意，结构即为应用实际写入的结构）：
# 书名
作者：作者名
导出时间：2026年9月12日
[在微信读书中打开](weread://book/123456)
## 第一章 章节名
> 划线原文第一行
> 划线原文第二行
**想法**
这里是我的个人想法
---
## 第二章 章节名可以看到：文件开头依次是书名、作者、导出时间与一个回到微信读书的深层链接；之后按章节以 ## 二级标题分节，划线原文用引用块呈现，紧跟其后的「想法」段落是你的个人批注；章节之间用分隔线隔开。这样的结构在 Obsidian 里既能顺畅阅读，也方便后续按章节检索和整理。
导出内容包含六个可独立开关的排版选项（与 Markdown 本地文件目标共用）：包含书名、包含作者姓名、包含导出时间戳、包含章节二级标题（##）、包含个人想法与批注、包含微信读书深度链接。你可以根据自己 Obsidian 仓库的整理习惯，决定一份笔记里保留哪些信息。
三步完成配置
把微信读书笔记同步到 Obsidian，配置本身只需要几分钟。
准备微信读书 API Key
前往微信读书开放服务页面，用微信读书账号扫码授权，复制以 wrk- 开头的 API Key，并在 ReadRelay 内粘贴一次完成连接（凭证加密保存在本机钥匙串）。
选择 Vault 目录
进入「设置 → 同步目标设置 → Obsidian」二级页，点击「选择 Vault 目录」，用 iOS 系统目录选择器选中你的 Obsidian 仓库（可选中 iCloud Drive 中的仓库）。应用会用安全作用域书签保存该目录授权，长期有效，也可随时重新选取或解绑。
同步并查看文件
回到书架选择要同步的书籍执行同步，应用即在 Vault 下创建 Books/ReadRelay/ 子目录并写入每本书的 Markdown 文件。打开 Obsidian 即可看到、检索并二次整理这些笔记。
同步方式与注意事项
长期有效的授权书签
应用使用安全作用域书签保存你选中的 Vault 目录授权，无需每次同步都重新选择。你可以随时在同一二级页重新选取其他仓库，或解绑当前目录。
每本书一个 Markdown 文件
同步会在 Vault 下创建 Books/ReadRelay/ 子目录，每本书写一个 Markdown 文件，文件名即书名；当书名包含 / 时会被替换为 -，避免被误判为多级路径。
只处理新增与变更
应用记录每本书的同步状态，默认只导出新增或变更内容，重复同步不会产生重复笔记。若清空同步记录，下次同步会重新全量导出。
未设置或授权失效
尚未设置目录时应用会提示「尚未设置 Obsidian 库目录」；当目录授权失效时会提示「无法访问所选的 Obsidian 库目录」，此时重新选取 Vault 目录即可恢复。
常见问题
微信读书笔记可以同步到 Obsidian 吗？
可以。ReadRelay 是 iPhone / iPad 原生应用，通过微信读书官方开放服务的 API Key 授权，把每本书的划线、高亮与想法写入你选定的 Obsidian Vault 目录。整个过程不依赖桌面端、Node 环境或社区插件，由你的设备直接在本地完成文件写入。
同步后的 Obsidian 文件保存在哪个位置？
同步时应用会在你选定的 Vault 下创建 Books/ReadRelay/ 子目录，每本书写入一个 Markdown 文件，文件名即书名（书名中的 / 会被替换为 -）。在 Obsidian 中打开该 Vault 即可看到 Books/ReadRelay 下的笔记，可直接阅读、检索与二次整理。
目录授权失效了怎么恢复？
如果提示「无法访问所选的 Obsidian 库目录」，说明之前保存的目录授权书签已失效。可在设置 → 同步目标设置 → Obsidian 二级页中重新点击「选择 Vault 目录」，用 iOS 系统目录选择器再次选中目标仓库即可恢复授权；应用会用安全作用域书签重新保存该目录授权，长期有效，也可随时解绑。
重复同步会重复写入笔记吗？
不会。ReadRelay 会记录每本书的同步状态，默认只处理新增或变更内容，重复同步不会产生重复笔记。若你在设置中清空同步记录，应用会认为所有笔记都是新的，下次同步将重新全量导出。
文件名中的书名包含斜杠 / 会出错吗？
不会。导出的 Markdown 文件名直接使用书名，但当书名中包含 / 时，应用会自动将其替换为 -，避免被 iOS 文件系统误判为多级目录路径，确保每本书都能正确落盘到 Books/ReadRelay/ 下。
相关页面
如果你还想了解其它同步目标，或需要通用的配置与排查说明，可以参考以下页面：
- ReadRelay 首页：了解核心能力与支持的同步目标总览。
- 同步目标：查看 Obsidian、Notion、flomo 与 Markdown 四种目标的差异。
- 支持与常见问题：API Key 获取、连接失败排查与各目标使用说明。
- 微信读书同步到 Notion：把笔记写入结构化数据库。
- 微信读书同步到 flomo：把每条划线推送到浮墨笔记。
- 微信读书导出 Markdown：导出标准本地 Markdown 文件。
把微信读书的划线，接进你的 Obsidian
ReadRelay 已在 App Store 上架。下载后用微信读书账号完成一次授权，选择你的 Obsidian Vault 目录，即可把书架、划线与想法导入知识库。