Acorny
← 返回博客

微信读书笔记导出:把划线和想法同步到 Markdown 与 Obsidian

微信读书是国内划线量最大的地方,也是最难把划线拿出来的地方。

官方给了你两个动作:复制,和生成一张分享卡片。复制一次只能拿一段,卡片是图片。想把一本书的全部划线整理成文字,只能一段一段来;想把三年积累的几十本书都拿出来,基本等于不可能。

这篇文章讲两条真正能走通的路,把微信读书的划线和想法导出成 Markdown 文件,或者直接同步进 Obsidian 仓库。两条路都不需要付费,选哪条取决于你平时是只划线,还是会顺手写想法。

微信读书为什么没有"导出"按钮

值得先说清楚,因为它决定了下面两条路为什么长这样。

微信读书的划线数据存在腾讯的服务器上,网页版和 App 通过内部接口读取。它从来没有提供过面向用户的批量导出接口——不是藏起来了,是产品上没做。所以社区里长期流传的方案都是一类:借用你自己已登录的会话,把接口返回的数据抓下来再整理。

这类方案的通病是脆——页面结构一改就废,而且大多是需要自己跑的脚本。下面两条路的区别在于,一条走的是微信读书自己开放出来的 Skill 接口,另一条走浏览器扩展在你的登录态里读数据,都不需要你碰命令行。

路线一:用官方 API Key 直接导入

微信读书开放了一个叫 Skill 的接口层,可以申请一个 API Key。这是目前最省事的一条路,全程在网页上完成,不用装任何东西。

  1. 打开微信读书的 Skill 页面,申请一个 API Key。它以 wrk- 开头。
  2. 在 Acorny 打开 Import 页面,选择从 API 导入,来源选 WeRead API
  3. 把 API Key 粘进去。下面有一个"最多导入条数",默认 500,最大可以调到 5000。
  4. 点预览。你会看到识别到多少本书、多少条高亮、多少条重复、多少条无效,确认没问题再提交。

拿到的是什么:你所有有笔记的书,每本书的划线和想法。章节标题会单独保留,作为每条高亮的标题;书名作为来源。

有几件事最好提前知道:

纯书签不会进来。 微信读书里只标记位置、没有划线的书签不算高亮,不会被导入。

默认 500 条,够不够要自己判断。 重度用户很容易超。超过上限时它是按书的顺序拉到额度用完为止,剩下的书不会报错,就是没进来——所以如果你的划线量大,第一次就把它调到 5000。

不支持增量。 每次导入都是全量拉取,已经在库里的会被识别为重复并跳过,不会产生副本,但也意味着每次都要等全量跑完。

想法会和它对应的划线合成一条。 微信读书里一条"想法"是挂在某段原文上的,接口返回的是两条独立记录:划线本身,和带批注的想法。导入时这两条会被识别成同一段落并合并,保留带批注的那条——你写的东西不会丢,也不会看到同一段原文出现两遍。

路线二:用浏览器扩展全量导出

Acorny 的浏览器扩展会在你已登录微信读书网页版的前提下,把全部有划线的书抓一遍,生成一个文件,再上传导入。步骤多两步,但拿到的数据更完整。

  1. 装好 Acorny 浏览器扩展,并在浏览器里登录微信读书网页版。
  2. 打开扩展的 Extension Settings,进入 WeRead Export 分区,打开导出页。
  3. 点开始。扩展会先取全量书单,再逐本拉划线、想法和章节信息,过程中显示总书数、已完成书数和当前正在处理的书名。书多的话这一步要跑几分钟,别关标签页。
  4. 跑完会生成一个 weread-export.json
  5. 回到 Acorny 的 Import 页面,把这个文件传上去,走和上面一样的预览 → 确认流程。

和 API 那条路的差别主要是没有条数上限——扩展走的是全量书单,一次跑完你所有有划线的书。想法的处理两边一致,同一段原文只留一条带批注的记录。

两条路怎么选

API Key 浏览器扩展
准备工作 申请一个 Key,网页上完成 装扩展 + 登录网页版
单次上限 默认 500,最大 5000 全量书单,无上限
划线与想法 完整 完整
增量同步 不支持,每次全量 不支持,每次全量
套餐 免费可用 免费可用

简单说:划线总量在几千条以内、想快速试一次,用 API Key;书多划线多、要一次迁完,用扩展。 两条路可以混着用,同一条划线在两边生成的标识是一样的,不会因为导入两次就出现两份。

导出成 Markdown 文件

数据进来之后,"导出成 Markdown"其实有两种意思,解决的是不同的问题。

你想要的 用哪个 套餐
一个能存档、能拿去处理的文件 Markdown 下载 任意套餐,含免费
划线出现在仓库里,并且一直保持最新 Obsidian 插件 Pro

下载给你的是一个即时生成的文件,下载完就和 Acorny 再无关系;插件给你的是每个来源一篇笔记,每次同步就地更新。

下载走这里:在 Acorny 打开 Extensions & Apps,找到 Export 区块,选 Markdown,文件就下来了。旁边还有 JSON 和 CSV,喂给脚本的话用那两个。这三种下载在任何套餐下都能用,包括免费账号。

下载拿到的是一份快照。下个月再下一次,你会得到一个包含全部内容的新文件,包括上次已经有的那些。存档没问题,往仓库里放就很别扭——这正是插件存在的理由。

同步进 Obsidian 仓库

Acorny Sync 插件从一个只读的导出源拉数据,往你指定的文件夹里写 Markdown 笔记。

需要先说清楚的是,插件读的这个导出源是 Pro 功能,所以它需要的导出令牌只有 Pro 账号能创建。上面那节的 Markdown 下载不受限制,免费账号一样能把全部划线拿出来。价格在套餐页

  1. 在 Acorny 打开 Settings,找到 Export tokens。免费账号这里显示的是升级提示,不是令牌控件。Pro 账号可以创建一个,起名比如 Obsidian,创建后立刻复制——它以 acornyexp_ 开头,并且只显示一次。这个令牌只能读你的高亮,不能往 Acorny 里写任何东西,也改不了账号。
  2. 在 Obsidian 里打开设置 → 第三方插件,如果开着安全模式就先关掉,然后搜索 Acorny Sync,安装并启用。
  3. 打开插件设置,把令牌粘进 Export tokenFolder 设成你想让笔记落在哪,默认是 AcornySync on startup 和自动同步间隔是可选的,间隔填 0 就完全关掉轮询,只在你手动触发时同步。
  4. 在命令面板里执行 Acorny: Sync now,或者点侧边栏图标。

同一时间只会有一个同步在跑。前一个还没结束时再触发,新的会被跳过而不是排队,所以手快点两下不会往同一个文件夹里写两遍。

同步出来的笔记长这样:

---
title: 思考,快与慢
author: 丹尼尔·卡尼曼
tags:
  - psychology
acorny-source-id: cmd8x2k9p0001
---

## Highlights

- 我们对自己的信念抱有的信心,主要取决于我们能就所见之事讲出一个怎样的故事,而不取决于我们见到的东西有多少。 ^acorny-cmd8x2k9p0007
    - note: 这解释了为什么单薄的证据也能产生强烈的确信。

每条高亮末尾的 ^acorny-<id> 是 Obsidian 的块引用标识,你可以在别的笔记里用 [[书名#^acorny-xxx]] 直接引用某一条划线。同步是按这个标识就地更新的,所以不要手动删它——删掉之后下次同步会认不出这条,重新追加一遍。

导出之后:文件夹换了,问题还在

到这一步,技术问题解决了。你的划线从一个封闭的 App 里出来了,变成了纯文本,存在你自己的硬盘上,可以搜索、可以引用、可以被任何工具处理。

然后大概率会发生这样一件事:你再也不会打开它们。

这不是懒。这是导出这个动作本身的边界——它把"在微信读书里不会再看"变成了"在 Obsidian 里不会再看"。文件夹换了一个,划线该沉底还是沉底。真正让你想划线的那个瞬间——"这个说得对"——在你划完的那一刻就已经消耗掉了,之后它就只是一条静静躺着的文本。

而且熟悉感会骗你。半年后你翻到那句话,会觉得"这个我知道"。但那是因为原文就在你眼前,是它在替你完成回忆。真正的检验是:合上页面,你还能把它说出来吗?大多数时候答案是不能,而这个差距在你重读的时候是看不见的。

要跨过这个差距,需要的是主动回忆:把一段划线变成一个问题,先尝试回答,再看答案,然后诚实评估自己记得多少。这比重读慢,也比重读难受,但重读能带来的"我记住了"的感觉,恰恰是最不可靠的那种信号。

这也是 Acorny 和"把高亮搬来搬去"的工具的区别所在。导入和导出只是让数据流动起来;真正的问题是让那些你曾经觉得重要的句子,在你需要它们的时候还在脑子里。所以进到 Acorny 的划线不只是躺在列表里,它们会按间隔重复的节奏重新出现在你面前,一次一条,让你先想再看。

要不要用它是另一回事。但如果你导出的目的是"以后能用上",那么导出只完成了一半。

小结

  • 想快速试一次:用 Skill 页面申请 API Key,在 Import 页面直连导入,记得把条数调到 5000。
  • 书多、划线多:装浏览器扩展,走 WeRead Export 生成文件再上传,没有条数上限。
  • 要存档:Markdown / JSON / CSV 下载,免费账号可用。
  • 要仓库里一直保持最新:Obsidian 装 Acorny Sync 插件,需要 Pro 的导出令牌。

两条导入路径都不是官方支持的接入方式,微信读书那边改了东西就可能需要跟着调整。数据全程在你自己的浏览器里流转,Acorny 不会碰你的微信读书账号密码。