把微信读书笔记导出为 Markdown
本文说明 ReadRelay 的 Markdown 同步目标:它与其他三个目标不同,默认就是开启的,连接微信读书账号后即可直接导出,不需要配置 Vault、Token 或 Webhook。适合想要一个干净、可长期保存、能随时迁移的纯文本备份的用户。
为什么用 Markdown 保存微信读书笔记
微信读书本身更擅长「读」,而不是「存」。划线散落在不同书目里,想法又和原文混在一起,时间一久就很难再把它们整理成自己的东西。把微信读书笔记导出为 Markdown,等于给每一本书做了一份你能完全掌控的文本备份:它是纯文本,不依赖任何专有软件,十年后依然能打开;它能被任何编辑器、笔记工具或 Git 仓库读取,也方便做全文检索和二次整理。
在 ReadRelay 的四个同步目标里,Markdown 本地文件是唯一开箱即用的目标:默认启用、无需任何配置,也不依赖网络。只要微信读书账号连接成功,执行一次同步,划线、高亮与想法就会被生成为 Markdown 文件,整个过程在设备本地完成,不经由任何中转服务器。这也是最轻量的微信读书划线导出方式——你不需要先去申请 Vault、Integration 或 Webhook,就能拿到第一份可迁移的笔记副本。
导出的文件长什么样
每本书生成一个独立的 .md 文件,文件名就是书名。文件开头依次写入书名、作者与导出时间,随后按书籍章节组织划线与想法。下面是一份真实结构的示例(其中的书籍 ID、章节名与划线内容均为示意):
# 书名
作者:作者名
导出时间:2026年9月12日
[在微信读书中打开](weread://book/123456)
## 第一章 章节名
> 划线原文第一行
> 划线原文第二行
**想法**
这里是我的个人想法
---
## 第二章 章节名
几个排版规则值得注意:章节与章节之间用一行 --- 分隔;划线统一写成 > 引用块,原文有几行就保留几行;你的个人想法以单独的 **想法** 段落开头,紧跟在对应章节之后。深度链接形如 [在微信读书中打开](weread://book/<书籍ID>),点击即可跳回微信读书 App 中对应的书。
文件命名规则
文件名即书名,扩展名固定为 .md,每本书一个文件,不存在多个书目混在一个文件里的情况。书名中若包含正斜杠 /,会被自动替换为连字符 -,避免被 iOS「文件」App 误识别为子目录路径。例如《人类简史/从动物到上帝》会生成名为 人类简史-从动物到上帝.md 的文件。
六个排版开关
上述示例里的每个部分都可以在设置页逐项开关,下面是六个开关及其作用:
- 包含书名:控制文件开头的
# 书名一级标题是否写入。多数情况下建议保留,方便在编辑器侧栏直接识别书目。 - 包含作者姓名:控制
作者:作者名一行。多作者或译著较多时,保留它有助于日后按作者归档。 - 包含导出时间戳:控制
导出时间:2026年9月12日这一行,采用中文日期格式,方便对照每次同步的时间。 - 包含章节二级标题(##):控制每个章是否以
## 第一章 章节名形式分节。关闭后,所有划线会顺次排列,不再按章节归组。 - 包含个人想法与批注:控制
**想法**段落是否生成。只想要纯粹划线摘录时,可在此关掉。 - 包含微信读书深度链接:控制文件头部的
weread://book/<书籍ID>跳转链接是否写入。需要点回原书复盘时建议保留。
这些开关互不影响,你可以为「长期归档」和「快速摘录」两种用途分别调整。正因为它们都是本地生成、纯文本输出,所以无论怎么组合,得到的都是标准 Markdown,任何编辑器都能正常打开。
三步导出
因为 Markdown 目标默认启用,整个导出流程比其它目标更短。按下面三步即可拿到第一份文件:
连接微信读书
在 ReadRelay 中粘贴微信读书开放服务申请到的 API Key,完成一次授权并连接账号。Markdown 目标此时已经处于可用状态,无需再单独开启。
选择 Markdown 目标
进入设置页的「Markdown 本地文件」二级页,确认路径为 Documents/ReadRelay,并核对六个排版开关是否符合你的需要。这里也可以随时查看目录或触发导出。
同步并查看
执行同步,应用为每本书生成对应的 .md 文件。随后在 iOS「文件」App 的「我的 iPhone / 我的 iPad → ReadRelay」中即可看到,微信读书导出 Markdown 的过程到此完成。
文件在哪里、如何备份与迁移
导出的文件完全属于你,存放在应用沙盒里,也能很方便地搬到其他地方。下面几种方式覆盖了从「只是看看」到「长期迁移」的不同需求:
在「文件」App 中打开
打开 iOS「文件」App,进入「我的 iPhone / 我的 iPad → ReadRelay」,即可逐本浏览导出的 Markdown。这里能看到文件名、修改时间与大小,也支持直接预览或发送到其它 App。
系统共享导出文件夹
设置页的「Markdown 本地文件」二级页提供「通过系统共享导出文件夹」按钮,可把整个 Documents/ReadRelay 目录一次性发送到云盘、邮件或其它文件管理工具。
迁移到 Markdown 编辑器
导出的文件是标准 Markdown,可拖入任意编辑器(如熊掌记、Typora、iA Writer 等)继续整理,不会因为换了工具而丢失格式或章节结构。
纳入 Git 版本管理
通过系统共享把 ReadRelay 目录拷到本地 Git 仓库后提交,即可对微信读书划线导出结果做版本追踪,每次同步的变更都能在历史里对照。
由于文件保存在应用沙盒中,删除 ReadRelay 并不影响已经导出到「文件」App 或迁移到其它位置的内容;但沙盒内未迁出的副本会随应用一同清除,建议定期用上面的方式备份。
常见问题
微信读书笔记可以导出为 Markdown 吗?
可以。ReadRelay 的 Markdown 目标是四个同步目标里唯一开箱即用的:默认启用、无需任何配置,也不依赖网络。连接微信读书账号后执行同步,应用会为每本书生成一个 .md 文件,写入应用沙盒的 Documents/ReadRelay 目录,纯本地离线生成,不经由任何服务器。
导出的 Markdown 文件保存在哪里?
文件保存在应用的 Documents/ReadRelay 目录。在 iOS「文件」App 中,进入「我的 iPhone / 我的 iPad → ReadRelay」即可看到对应文件;也可在设置页的「Markdown 本地文件」二级页查看路径,并通过「通过系统共享导出文件夹」按钮,把整个目录导出到其他 App 或云盘。
文件名是怎么命名的?
文件名即书名,扩展名为 .md,每本书对应一个独立文件。如果书名中包含正斜杠「/」,会被自动替换为连字符「-」,避免被系统误识别为子目录。例如书籍《人类简史/从动物到上帝》会生成「人类简史-从动物到上帝.md」。
导出时间显示的格式是什么?
导出时间使用中文日期格式,例如「2026年9月12日」,写在每本书 Markdown 文件开头的「导出时间」一行。该时间戳、书名、作者、章节标题、个人想法与微信读书深度链接,均可在设置页逐项开关,按需保留或移除。
重复同步会产生重复文件或内容吗?
不会重复。ReadRelay 会记录每本书的同步状态,默认只导出新增或变更的内容,多次同步同一本书只会更新对应文件,不会生成多余的副本。若在设置中清空同步记录,下次同步会重新全量导出该书。
相关页面
- ReadRelay 首页:了解四类同步目标与整体能力。
- 同步目标总览:对比 Markdown、Obsidian、Notion 与 flomo 的差异。
- 支持与常见问题:密钥配置、同步排查与各目标的通用说明。
- 微信读书同步到 Obsidian:写入 Vault 的
Books/ReadRelay/目录。 - 微信读书同步到 Notion:结构化数据库中的每本书记录。
- 微信读书同步到 flomo:把划线推送为浮墨 MEMO 卡片。
把微信读书的划线,导出成你自己的 Markdown
ReadRelay 已在 App Store 上架。下载后用微信读书账号完成一次授权,Markdown 目标默认开启,立即就能生成第一份 <书名>.md 备份。