Obsidian Weread Plugin

Obsidian微信读书插件是一个社区插件，用来同步微信读书中书籍元信息、高亮标注，划线感想、书评等，并将这些信息转换为markdown格式保存到Obsidian的文件夹中，初次使用，如果笔记数量较多，更新会比较慢，后面再去更新的时候只会更新划线数量或者笔记数量有变化的书籍，一般速度很快。

更新历史

https://github.com/zhaohongxuan/obsidian-weread-plugin/releases

功能

• 同步书籍元数据例如：书籍封面，作者、出版社、ISBN，出版时间等
• 同步微信读书的高亮划线
• 读书笔记分为划线笔记，页面笔记， 章节笔记，书籍书评
• 支持微信扫码登录，理论上可以和浏览器一样保持长时间不掉线。
• 校验Cookie有效期自动刷新Cookie
• 自定义笔记生成模板 template
• 文件名支持多种格式设置
• 自定义FrontMatter，可在头部yaml文件中增加自己需要的字段，比如标签，阅读状态等
• 公众号划线和笔记归类同步
• 支持移动端同步，可以在手机和平板上使用本插件
• 支持Daily Notes,将当日读书笔记同步至Daily Notes中，已经在0.4.0中支持
• 微信读书书架功能，展示本地同步的书籍汇总数据
• 主题管理：内置三种主题模板，支持导入导出，自定义主题

安装方法

插件市场直接搜索weread，找到Weread Plugin点击install安装，安装完成后点击Enable使插件启用，也可以直接在release页面手动下载。

设置

1. 打开Obsidian点击设置进入设置界面，找到Obsidian Weread Plugin进入到插件设置页面
2. 点击右侧登录按钮，在弹出的登录页面扫码登录，登录完成后，会显示个人昵称
3. 点击注销按钮即可注销登录，系统会自动清除Obsidian插件的Cookie信息
4. 设置笔记保存位置，笔记最小划线数量，笔记文件夹分类

使用

⚠️ 本插件是覆盖式更新，请不要在同步的文件里修改内容，写永久笔记（为什么写永久笔记参考《卡片笔记写作法》）的时候可以使用Block引用 的方式，在外部引用进行批注。

基础使用

1. 点击左侧Ribbon上的微信读书按钮，或者command+P(windows ctrl+P)调出Command Pattle 输入Weread 找到Sync Weread command即可同步。
2. 默认模板效果(theme:minimal) 使用dataview+minimal cards的显示效果，参考这里：

同步笔记到Daily Notes

1. 在设置中打开同步到Daily Notes的开关，然后分别设置Daily Notes的目录以及文件格式
2. 如果Daily Note是Periodic Notes管理的，可以改成Periodic Notes的格式，比如我使用的格式YYYY/[W]ww/YYYY-MM-DD，就会按照 年/周/日的维度在文件夹中寻找Daily Notes.
3. 设置在Daily Notes的特定的区间插入，可以修改默认值为你想要的markdown格式的内容，比如在某两个标题之间插入，注意📢，区间内的内容是会被覆盖的，不要在区间内修改文本。

主题管理

插件内置三种主题模板，支持导入导出和自定义主题。

内置主题

主题	说明
合并式模板	划线和想法 inline 展示，适合快速回顾
分离式模板	先展示纯划线，笔记统一在底部，适合整理归纳
微信官方笔记主题	详细的元数据信息，适合生成书籍笔记

主题类型

类型	说明
内置	插件自带，不可删除，不可编辑
自定义	用户创建，可编辑、复制、导出
旧模板	从旧版本迁移的模板，不可编辑，只能复制后自定义

使用主题

1. 在插件设置中打开主题管理
2. 选择想要使用的主题，点击「使用此主题」
3. 当前使用中的主题会显示「✓ 使用中」标签

创建自定义主题

1. 选择任意内置主题，点击「复制并自定义」
2. 系统会创建该主题的副本并自动设为使用中
3. 点击「编辑」修改模板内容或设置项

导入导出

• 导出：点击主题的「导出」按钮，下载 JSON 文件
• 导入：支持从本地文件或 URL 导入主题

详细指南请查看主题贡献指南。

已知问题

• 长期不使用本插件Cookie可能会失效，需要重新登录。
• 偶尔可能会有网络连接问题，重新点击同步即可，已同步的笔记不会再次更新。

TODO

• 解决Obsidian中CORS问题
• 设置界面笔记保存路径
• 优化文件同步逻辑，不需要每次都删除重建，可以根据Note的数量来判断
• 被动刷新Cookie延长有效期
• 多处登录导致Cookie失效Fix
• 弹出扫码框登录自动获取Cookie
• 书名重复导致同步失败
• 设置页面支持设置Template格式
• 文件名模板
• 移动端适配
• 阅读状态元数据，比如阅读中，阅读完成等等，以及阅读时间的分布等
• 按照章节Index进行排序
• 保留多个章节层级
• 同步微信公众号文章
• 模板预览功能
• 设置页面，目录选择优化 #39
• 导出热门划线 #42

Weread API

Weread API

赞赏

免责声明

本程序没有爬取任何书籍内容，只提供登录用户的图书以及笔记信息，没有侵犯书籍作者版权和微信读书官方利益。

感谢

• wereader
• Kindle Plugin
• Hypothesis Plugin
• Obsidian Plugin Developer Docs
• http proxy middleware
• nunjucks

Star History