Weave EPUB Reader

中文 | 繁體中文 | English | Español | Français | 日本語 | 한국어 | Русский | العربية

中文文档

插件介绍

如果你希望 Obsidian 不只是笔记仓库，也是你正经读书的地方，可以试试 Weave EPUB Reader。

它适合：边读边把句子记进 Markdown 的人；做专题研究、想把摘录画进 Canvas 的人；用 Weave 做间隔复习、想把书中段落制成卡片的人；同时推进多本书、需要月历排期而不是「开十本读半页」的人。

上手很轻：把 EPUB 放进 Vault，从书架打开，选中文字即可摘录。摘录会带着回到原书的位置信息；你改笔记、删摘录或换颜色，书里的高亮也会跟着变。更完整的五条工作流（自动摘录、Canvas、制卡、回链、增量阅读）见下方 摘录笔记工作流 图示——按自己的习惯选一条路走即可。

核心功能特性清单

阅读与书架

• 桌面 / 移动端全平台阅读
• EPUB、TXT、FB2/FBZ 阅读（MOBI、AZW3、CBZ 为高级）
• 我的书架：导入、封面、进度、搜索筛选、阅读状态
• 翻页 / 连续滚动、单页 / 双栏、宽度与排版调节
• 阅读进度持久化、书签、剩余阅读时间估算
• 段落阅读模式、沉浸式全屏、参考阅读点（高级）
• 书架书单（高级）

摘录与标注

• 五色高亮 + 下划线 / 删除线 / 波浪线
• 想法气泡（---div---）
• 自动模式：插入笔记 / 复制剪贴板
• Markdown / Canvas / Weave 牌组正文回显与同步
• 截图摘录（可翻页续截）

摘录汇总

• 摘录笔记汇总卡片列表（筛选、排序、定位原文）
• 摘录笔记汇总时间线视图（按日期回顾、跳转原文）
• 批量选择：导出 / 删除
• 目录侧栏全书地图密度条

溯源与联动

• 书籍深链接写入摘录
• 双向溯源精确定位：笔记 ↔ 原书（高级）
• Canvas 绑定、自动写入节点、回显
• 制卡 / 增量阅读 / AI（需 Weave，不占阅读器高级许可）

导出与辅助

• 导出当前章为 Markdown（基础）
• 导出全书 / 本章摘录、带标记章节（高级）
• 导出模板工作室与内置预设
• 脚注浮窗预览（高级）
• 多语言界面（简体中文、繁體中文、English、日本語、한국어、Русский、Deutsch、Español、العربية）+ 应用内使用教程

各能力在 基础体验与高级支持 中的划分见下表。

最低 Obsidian 版本：1.8.7

摘录笔记工作流

下方图示概括整体结构（GitHub / Obsidian 均可渲染 Mermaid）。

图 1 · 五条工作流怎么选（按目标分流）

中心是「在 Obsidian 内读书」；向外是按目标选择的五条典型路径。

flowchart TB
  READ(["在 Obsidian 内阅读<br/>Weave EPUB Reader"])

  READ --> A["A 自动 Markdown 摘录<br/>记到哪"]
  READ --> B["B Canvas 视觉整理<br/>画结构"]
  READ --> C["C 记忆回顾<br/>制卡复习"]
  READ --> D["D 回链复盘<br/>笔记 ↔ 原书"]
  READ --> E["E 增量阅读<br/>何时读哪章"]

  A --> LOOP["汇入核心闭环<br/>读→记→显→回"]
  B --> LOOP
  C --> LOOP
  D --> LOOP
  E --> LOOP

图 2 · 增量阅读子流程（工作流 E）

解决「多本书如何交错推进、长书如何按章深度读」，与自动摘录（工作流 A）互补：E 管排期，A 管记下什么。

flowchart LR
  TOC["目录：当前章节<br/>添加到增量阅读"]
  CAL["Weave 增量阅读<br/>月历视图排期"]
  MIX["多本书 · 多章节<br/>交错调度"]
  DAY["调度日<br/>打开任务"]
  BOOK["深链接回到<br/>书中章节/段落"]
  DEEP["阅读点 / 续读点<br/>深度精读"]
  LOOP["读→记→显→回<br/>摘录 · 回链 · 回显"]

  TOC --> CAL --> MIX --> DAY --> BOOK --> DEEP --> LOOP

五条典型工作流

A. 自动 Markdown 摘录（最常用）

适合「边读边记、笔记就是主战场」：

1. 先打开一本 Markdown 作为摘录笔记本，光标放在要插入的位置（与阅读器分屏体验最佳）。
2. 打开阅读器，开启工具栏 自动模式（闪电图标：开 = 插入，关 = 复制到剪贴板）。
3. 在书中选中文本并摘录 → 带定位的摘录块（含书籍深链接）自动插入到上一步光标处。
4. 保存笔记后，再次打开该书，正文会在对应段落回显高亮——你在笔记里记过什么，打开书就能看见。

详见上文 工作流 A。

B. Canvas 视觉整理

适合「做专题、画结构、理清论点关系」：

1. 为当前书绑定一个 Canvas 文件。
2. 开启自动模式后，摘录可自动写入 Canvas 新节点（可调整节点排布方向）。
3. 在 Canvas 里拖拽、连线、分组；阅读器识别绑定 Canvas 中的摘录并回显到正文。

C. 记忆回顾

适合「摘录之后要复习、要间隔重复」：

1. 选中文本 → 工具栏 制卡，进入 Weave 记忆卡片窗口。
2. 保存到 .wdeck 等牌组文件后，阅读器从牌组数据回显高亮。
3. 在 Weave 记忆模块中按牌组规则做复习；需要时仍可回到书中原文。

D. 回链复盘

适合「先摘录、后复习、再回原文」：

1. 在 Markdown / Canvas / 牌组笔记里查看历史摘录；打开书时正文侧已有回显高亮。
2. 点击笔记中的书籍深链接 → 跳回原文段落。
3. 在阅读器里点击某条高亮 → 一键定位到来源笔记，完成「笔记 ↔ 原书」双向溯源。

E. 增量阅读：多书交错与深度精读

适合「不想一次读完一本、而是多本书按节奏交错推进，并在月历里看见整体阅读计划」：

1. 把当前章节加入增量阅读：在阅读器侧边栏 目录 中，对某一章使用 「添加到增量阅读」（可选择一个增量阅读专题），将该章纳入增量阅读任务。
2. 进入月历视图统一调度：章节会出现在 Weave 增量阅读月历视图 中，与来自其他书籍、其他章节的阅读点一起排期——实现 多本书的交错阅读，而不是在书架里同时开很多本却都读不深。
3. 深度阅读而非浅尝辄止：
   • 选中文本 → 创建 增量阅读点（保留 EPUB 溯源深链接），把段落级内容纳入后续处理；
   • 阅读过程中可标记 增量阅读续读点，下次从增量阅读流程一键回到书中精确位置继续。
4. 到调度日时，从月历或任务列表打开对应项 → 经深链接回到原书章节/段落，与摘录、回链工作流衔接。

这与工作流 A（边读边记）互补：A 解决「记到哪」；E 解决「何时读哪一章、多本书如何轮流推进」。

和「只用外部阅读器 + 手动粘贴」相比

• 少一次上下文切换：不必为了记一句而离开 Obsidian。
• 摘录可沉淀、可检索：内容在 Vault 的 Markdown / Canvas / 牌组里，而不是散落在剪贴板历史里。
• 复习时原文仍在场：笔记是索引，书是现场；两者通过深链接与正文回显连在一起。
• 多端一致：书与笔记都在 Vault 里，随 Obsidian 同步策略走；手机读、桌面整理可以同一条链路。
• 长书与多书有节奏：章节可进入增量阅读月历，按调度交错阅读，而不是靠意志力硬啃单本。

更完整的操作说明见上文 摘录笔记工作流 与 核心功能特性清单。

基础体验与高级支持

图例：✅ 已包含 · 🔒 需启用高级支持

• 启用高级支持：在阅读器设置中使用 EPUB 独立激活码；若已安装并激活 Weave 主插件，可继承授权而无需重复输入。
• 制卡 / 增量阅读 / AI：不单独占用阅读器高级支持许可，但需安装 Weave；AI 另需自行配置 API Key。

完整对照见上文 基础体验与高级支持；激活在阅读器设置中完成，条款见 PREMIUM_TERMS.md。

安装

方式一：社区插件（推荐）

1. 打开 设置 → 社区插件 → 浏览
2. 搜索 Weave EPUB Reader，安装并启用

方式二：手动安装

1. 从 GitHub Releases 下载与 manifest.json 版本号一致的发布包，获取：
   • main.js
   • manifest.json
   • styles.css
2. 复制到 .obsidian/plugins/weave-epub-reader/
3. 重启 Obsidian，在 设置 → 社区插件 中启用 Weave EPUB Reader

快速开始

1. 启用插件后，通过功能区图标或命令面板打开书架，从 Vault 导入或打开图书。
2. 新建或打开一个 Markdown 文件，把光标放在需要插入摘录的位置；启用阅读器的自动摘录。选中文本，创建高亮、摘录或书签，内容会自动写入该位置。
3. 点击正文中的高亮，在工具条中跳转到来源笔记；在保存摘录的 Markdown / Canvas 中点击摘录旁的书籍图标，即可回到书中对应位置。
4. 阅读器菜单 → 帮助 → 使用教程 可查看插件内精简教程。工作流细节见上文 摘录笔记工作流。

数据与同步

建议同步（位于 Vault）：图书文件、Markdown 摘录、Canvas、Weave 牌组数据，以及每本书的进度与书签专有笔记（默认 Weave EPUB Reader/data_*.md）。

通常不需跨设备同步（位于插件目录）：阅读缓存、索引、Canvas 绑定与参考阅读点等本地状态。多设备使用时优先同步 Vault 内容，而非直接同步 .obsidian/plugins/weave-epub-reader/ 下的缓存文件。

隐私与网络

• 阅读、渲染、摘录与回链等默认在本地完成，不会主动上传 Vault 内容。
• 书架、回链与来源定位等功能会在本地枚举 Vault 文件路径；复制摘录或激活码时会访问剪贴板。详见 PRIVACY.md。
• 高级支持激活可能访问许可证服务（激活码、邮箱、设备指纹摘要等），详见 PRIVACY.md。
• AI 功能会调用你自行配置的第三方服务。

常见问题

如何正确的做阅读摘录笔记？

阅读摘录笔记保存在你选择的 Markdown、Canvas，以及 Weave 牌组文件中的具体位置；阅读器通过汇总这些摘录中的溯源链接，在正文中回显高亮。若不满足上述保存条件，选中摘录只会短暂高亮，不会留下可同步的实质数据。阅读器顶部的教程浮窗有更详细的说明。

与 Weave 的关系？

Weave EPUB Reader 可独立使用：不安装 Weave 主插件，也能在 Obsidian 里阅读 EPUB、管理书架，并完成基础摘录与正文回显。安装 Weave 后，可额外衔接制卡复习、增量阅读月历、AI 菜单等能力，并可继承 Weave 授权以启用阅读器高级支持。二者是可选联动，不是硬性依赖。

摘录笔记能否全平台同步？

支持。 摘录落在 Vault 内的 Markdown、Canvas、牌组等文件中，会随你使用的 Obsidian 同步方式（官方 Sync、iCloud、网盘同步 Vault 等）在桌面端与移动端之间保持一致。建议同步 Vault 内容；阅读器缓存等插件目录数据通常无需跨设备同步（见上文 数据与同步）。

是否支持导出笔记？

支持。 摘录与高亮相关数据保存在你的库内，可在 Obsidian 中直接查看、编辑与导出 Markdown；阅读器也提供章节导出等能力。数据默认完全本地化，不会主动上传你的 Vault 内容。

为何提供高级付费？

高级支持用于支持持续开发——让开发者能长期投入、打磨阅读与摘录细节。基础体验免费，已覆盖日常阅读、五色高亮、想法、摘录与正文回显等核心能力，上手体验完整；若你需要多格式、双向溯源、段落阅读模式等进阶能力，再按需启用高级支持即可。

是订阅还是买断？

阅读器高级支持采用买断制（一次激活，长期使用，具体以 高级支持条款 为准），而非按月订阅。

非 EPUB 格式打不开？

EPUB、TXT、FB2/FBZ 在基础体验中即可阅读；MOBI、AZW3、CBZ 等需启用高级支持。详见上文 基础体验与高级支持。

插件文件夹名称？

插件 ID 为 weave-epub-reader，路径：.obsidian/plugins/weave-epub-reader/

更多文档

• 插件介绍（简体中文）
• 插件介绍（繁體中文）
• Español · Français · العربية
• 隐私说明 · 高级支持条款 · 支持 · 安全

许可证与作者

源码基于 GPL-3.0-or-later 发布。

• Author: Rabbit (zhuzhige)
• GitHub: https://github.com/zhuzhige123

English Documentation

Introduction

If you want Obsidian to be more than a note archive—a place where you actually read—Weave EPUB Reader is worth a look.

It fits readers who capture sentences into Markdown as they go; researchers who map excerpts onto Canvas; Weave users who turn passages into cards for spaced repetition; and anyone juggling several books who prefers a month-calendar rhythm over “ten books open, half a page each.”

Getting started is light: put an EPUB in your vault, open it from the bookshelf, select text, and excerpt. Each capture keeps a link back to the same passage in the book; when you edit, delete, or recolor notes, highlights in the text update to match. Five fuller paths—auto excerpts, Canvas, cards, backlinks, incremental reading—are diagrammed in Excerpt and note workflows below; follow the one that matches your habit.

Core feature checklist

Reading and bookshelf

• Full-platform reading on desktop and mobile
• EPUB, TXT, and FB2/FBZ reading (MOBI, AZW3, and CBZ are Premium)
• My bookshelf: import, covers, progress, search/filter, reading status
• Paginated / continuous scroll, single / dual column, width and typography controls
• Persistent reading progress, bookmarks, remaining-time estimates
• Paragraph reading mode, immersive fullscreen, reference reading points (Premium)
• Bookshelf playlists (Premium)

Excerpts and annotations

• Five highlight colors plus underline / strikethrough / wavy underline
• Thought bubbles (---div---)
• Auto mode: insert into notes / copy to clipboard
• In-body rendering and sync for Markdown / Canvas / Weave decks
• Screenshot excerpts (can continue across pages)

Excerpt summaries

• Excerpt card list (filter, sort, jump to source)
• Excerpt timeline view (review by date, jump to source)
• Batch select: export / delete
• TOC sidebar book-map density bar

Tracing and integrations

• Book deep links written into excerpts
• Precise two-way tracing: notes ↔ book (Premium)
• Canvas binding, auto node creation, and rendering
• Card making / incremental reading / AI (requires Weave; does not consume reader Premium license)

Export and helpers

• Export current chapter to Markdown (Essential)
• Export whole-book / chapter excerpts and marked chapters (Premium)
• Export template studio with built-in presets
• Footnote hover preview (Premium)
• Multilingual UI (Simplified Chinese, Traditional Chinese, English, Japanese, Korean, Russian, German, Spanish, Arabic) + in-app tutorial

See Essential experience and Premium support for how capabilities are grouped.

Minimum Obsidian version: 1.8.7

Excerpt and note workflows

The diagrams below summarize the structure (Mermaid renders on GitHub and in Obsidian).

Diagram 1 · Pick a workflow (goal-based map)

Reading in Obsidian is the hub; each branch is a typical path you can follow by goal.

flowchart TB
  READ(["Read inside Obsidian<br/>Weave EPUB Reader"])

  READ --> A["A Auto Markdown excerpts<br/>where to capture"]
  READ --> B["B Canvas mapping<br/>structure"]
  READ --> C["C Memory review<br/>cards"]
  READ --> D["D Backlink review<br/>notes ↔ book"]
  READ --> E["E Incremental reading<br/>when to read"]

  A --> LOOP["Join the core loop<br/>read→capture→render→return"]
  B --> LOOP
  C --> LOOP
  D --> LOOP
  E --> LOOP

Diagram 2 · Incremental reading subflow (workflow E)

Answers how several books advance on a schedule and complements auto excerpts (workflow A): E schedules chapters; A captures what you noted.

flowchart LR
  TOC["TOC: Add current chapter<br/>to incremental reading"]
  CAL["Weave IR<br/>month calendar"]
  MIX["Multiple books & chapters<br/>interleaved schedule"]
  DAY["Scheduled day<br/>open task"]
  BOOK["Deep link back to<br/>chapter or passage"]
  DEEP["IR point / resume point<br/>deep reading"]
  LOOP["read→capture→render→return<br/>excerpts · backlinks · rendering"]

  TOC --> CAL --> MIX --> DAY --> BOOK --> DEEP --> LOOP

Five typical workflows

A. Auto Markdown excerpts (most common)

Best when notes are your primary workspace while reading:

1. First, open a Markdown note as your excerpt notebook and place the cursor where inserts should go (split view works best).
2. Open the reader and turn on Auto mode in the toolbar (lightning icon: on = insert, off = copy to clipboard).
3. Select text in the book and excerpt → a located excerpt block (with a book deep link) is inserted at that cursor.
4. After saving the note, reopen the book: matching passages show highlights in the body—what you captured in notes is visible in the book.

See workflow A above.

B. Canvas visual mapping

Best for topics, structure, and relationships:

1. Bind a Canvas file to the current book.
2. With Auto mode on, excerpts can auto-create Canvas nodes (layout direction is configurable).
3. Arrange nodes in the Canvas; the reader renders related excerpts back into the book.

C. Memory review

Best when excerpts should enter spaced repetition:

1. Select text → Make card in the toolbar → Weave card editor.
2. Save to .wdeck or other deck files; the reader renders highlights from deck data.
3. Review in Weave; jump back to the book when you need the original passage.

D. Backlink review

Best for excerpt first, review later, return to source:

1. Review past excerpts in Markdown / Canvas / decks; reopen the book to see highlights in the body.
2. Click a book deep link in a note → jump to the original passage.
3. Click a highlight in the reader → open the source note (two-way tracing).

E. Incremental reading: interleaved multi-book deep reading

Best when you want several books to advance on a rhythm instead of reading one cover-to-cover in a single sprint:

1. Add the current chapter to incremental reading: In the reader sidebar table of contents, use Add to incremental reading on a chapter (optionally pick an incremental-reading topic) to enqueue that chapter.
2. Schedule in the month calendar: The chapter appears in Weave’s incremental reading month calendar alongside reading points from other books and chapters—interleaved multi-book reading instead of leaving many books half-open on the shelf.
3. Deep reading, not skimming:
   • Select text → create an incremental reading point (keeps an EPUB source deep link) for paragraph-level follow-up;
   • While reading, mark an incremental reading resume point so the next IR session jumps back to the exact location in the book.
4. On a scheduled day, open the item from the calendar or task list → follow the deep link back to the chapter or passage, then continue with excerpts and backlinks.

This complements workflow A: A is where captures go; E is when each chapter gets read across multiple books.

Compared with “external reader + manual paste”

• Fewer context switches—no leaving Obsidian to capture a sentence.
• Excerpts become durable vault knowledge—searchable in Markdown, Canvas, or decks—not clipboard history.
• Review keeps the source in view—notes index what you read; the book shows the live context via deep links and rendering.
• Same workflow across devices—books and notes live in the vault and follow your Obsidian sync setup.
• Rhythm for long or multiple books—chapters enter the incremental reading calendar for scheduled, interleaved progress.

More detail: Excerpt and note workflows and Core feature checklist above.

Essential experience and Premium support

Legend: ✅ included · 🔒 requires Premium support

• Enable Premium support: EPUB-only license in reader settings, or inherit from an activated Weave main plugin.
• Card making / incremental reading / AI: No separate EPUB Premium-support license slot, but require Weave; AI also needs your own API key.

Authoritative breakdown: Essential experience and Premium support above. Activate in reader settings. Terms: PREMIUM_TERMS.md.

Installation

Option 1: Community plugins (recommended)

1. Open Settings → Community plugins → Browse
2. Search for Weave EPUB Reader, install, and enable

Option 2: Manual installation

1. Download a GitHub release matching the version in manifest.json:
   • main.js
   • manifest.json
   • styles.css
2. Copy into .obsidian/plugins/weave-epub-reader/
3. Restart Obsidian and enable Weave EPUB Reader under Settings → Community plugins

Quick start

1. Open the bookshelf from the ribbon or command palette, then import or open a book from your vault.
2. Create or open a Markdown file and place the cursor where excerpts should go; turn on Auto excerpt in the reader. Select text to create highlights, excerpts, or bookmarks—they are inserted at that cursor.
3. Click a highlight in the book to jump to its source note from the toolbar; in the Markdown / Canvas that holds the excerpt, click the book icon next to it to return to the matching passage.
4. Reader menu → Help → Tutorial for in-app guidance. For workflow details, see Excerpt and note workflows above.

Data and sync

Good to sync (in the vault): Book files, Markdown excerpts, Canvas files, Weave deck data, and per-book progress/bookmark notes (default Weave EPUB Reader/data_*.md).

Usually local (plugin folder): Reader cache, indexes, Canvas bindings, reference reading points, and similar local state. Prefer syncing vault content across devices rather than .obsidian/plugins/weave-epub-reader/ cache files.

Privacy and network

• Reading, rendering, excerpting, and backlinks are local by default; vault content is not uploaded proactively.
• Bookshelf, backlink, and source-locate features enumerate vault file paths locally; copying excerpts or activation codes uses the clipboard. See PRIVACY.md.
• Premium support activation may contact the license service (activation code, email, device fingerprint summary, etc.). See PRIVACY.md.
• AI features call the third-party services you configure.

FAQ

How do I capture reading excerpts correctly?

Excerpts are stored at concrete locations in the Markdown, Canvas, or Weave deck files you choose. The reader aggregates source links from those captures and renders highlights in the book. Selections that are not saved this way only flash briefly and leave no durable data. The in-reader tutorial banner explains this in more detail.

How does this relate to Weave?

Weave EPUB Reader works on its own: without the Weave main plugin, you can still read EPUBs, use the bookshelf, and capture excerpts with in-body rendering. With Weave installed, you can also connect spaced-repetition cards, incremental reading calendar, AI actions, and inherit Weave licensing for Premium support. The two are optional companions, not a hard dependency.

Can excerpts and notes sync across platforms?

Yes. Captures live in Markdown, Canvas, deck files, and other vault content, so they follow whatever Obsidian sync you already use (Obsidian Sync, iCloud, cloud-synced vaults, etc.) across desktop and mobile. Sync vault content; reader cache under the plugin folder usually does not need cross-device sync (see Data and sync above).

Can I export my notes?

Yes. Excerpt and highlight data stays in your vault—you can read, edit, and export Markdown in Obsidian, and the reader offers chapter export and related tools. Data is local by default; your vault is not uploaded proactively.

Why is Premium support paid?

Premium support funds ongoing development so the reader and excerpt workflow can keep improving. The essential experience is free—daily reading, five highlight colors, annotations, excerpts, and in-body rendering are fully usable without paying. Enable Premium support only when you want formats, two-way tracing, paragraph reading mode, and other advanced capabilities.

Subscription or one-time purchase?

Premium support is buy-once (activate once, use long-term; see Premium support terms), not a monthly subscription.

Cannot open non-EPUB formats?

EPUB, TXT, and FB2/FBZ are included in the essential experience. MOBI, AZW3, and CBZ require Premium support. See Essential experience and Premium support above.

Plugin folder name?

Plugin ID: weave-epub-reader → .obsidian/plugins/weave-epub-reader/

More documentation

• Introduction (Simplified Chinese)
• Introduction (Traditional Chinese)
• Español · Français · العربية
• Privacy · Premium support terms · Support · Security

License and author

Source code is released under GPL-3.0-or-later.

• Author: Rabbit (zhuzhige)
• GitHub: https://github.com/zhuzhige123