Obsidian EPUB 阅读方案汇总

更新时间：2026-04-18

结论

如果你的目标是：

• 在 Obsidian 里直接打开 .epub
• 支持目录、阅读位置记忆、字体大小调节
• 支持上下连续滚动

那么现在已经恢复并重新安装了 obsidian-epub-plugin。

如果你的目标更偏向：

• 上下滚动式长文阅读
• 更稳定的中文排版
• 后续做高亮、双链、批注、摘录、搜索

那么更适合长期使用的是：先用 epub-importer 把 EPUB 导入成 Markdown，再在 Obsidian 里阅读。

也就是说，现在保留了两套方案：

1. obsidian-epub-plugin：适合“直接读 EPUB 原书”
2. epub-importer：适合“导入成 Markdown 后长期阅读和知识管理”

已汇总到的目录

当前生效的 Vault 路径：

• E:\My Project\Atramenti-Console\codex\plugins\obsidian\data

其中包含：

• .obsidian\plugins：当前已安装插件
• .obsidian\snippets：阅读样式片段
• docs\books：当前书库与导入结果
• importer-backups：EPUB 导入时的备份目录

当前已安装插件

1. ePub Reader

安装位置：

• E:\My Project\Atramenti-Console\codex\plugins\obsidian\data\.obsidian\plugins\obsidian-epub-plugin

来源：

• 官方仓库：https://github.com/caronchen/obsidian-epub-plugin
• 本地恢复源码：历史恢复阶段目录，当前未保留在仓库内
• 本地编译产物：当前以已安装插件目录为准，不再单独保留 plugin-recovery 构建目录

已确认功能（来自源码和已编译文件）：

• 直接打开 .epub
• 显示 TOC 目录
• 记忆阅读位置
• 字体大小调节
• 跟随亮/暗主题
• 支持连续滚动阅读（flow: "scrolled" + manager: "continuous"）
• 支持从面板菜单创建对应笔记（Create new epub note）

当前设置：

• scrolledView: true
• notePath: /
• useSameFolder: true
• tags: notes/booknotes

设置文件：

• E:\My Project\Atramenti-Console\codex\plugins\obsidian\data\.obsidian\plugins\obsidian-epub-plugin\data.json

2. Epub Importer

安装位置：

• E:\My Project\Atramenti-Console\codex\plugins\obsidian\data\.obsidian\plugins\epub-importer

来源：

• 官方仓库：https://github.com/aoout/obsidian-epub-importer
• 本地恢复源码：历史恢复阶段目录，当前未保留在仓库内
• 本地编译产物：当前以已安装插件目录为准，不再单独保留 plugin-recovery 构建目录

已确认能力（来自 README / 设置项 / 编译产物）：

• 把 EPUB 导入为一组 Markdown 笔记
• 可配置书库目录 libraries
• 可配置保存目录 savePath
• 支持图片资源拆分存放
• 支持导入重排版 reformatting
• 支持阅读进度管理 enableReadProgressManager
• 适合后续进行 Obsidian 原生检索、双链、标签、摘录和批注

当前设置：

• 书库目录：E:\My Project\Atramenti-Console\codex\plugins\obsidian\data\docs\books
• 导入目录：docs/books/imported_markdown
• 图片目录模板：{{savePath}}/{{bookName}}/images
• 备份目录：历史恢复阶段目录，当前未保留在仓库内
• 已开启 reformatting
• 已开启阅读进度管理

设置文件：

• E:\My Project\Atramenti-Console\codex\plugins\obsidian\data\.obsidian\plugins\epub-importer\data.json

中文排版增强

为了让导入后的 Markdown 书籍更适合中文长文阅读，已经额外添加了一个只作用于导入书目录的 CSS 片段。

文件位置：

• E:\My Project\Atramenti-Console\codex\plugins\obsidian\data\.obsidian\snippets\epub-reading-enhanced.css

启用记录：

• E:\My Project\Atramenti-Console\codex\plugins\obsidian\data\.obsidian\appearance.json

主要增强内容：

• 中文衬线字体优先
• 正文字号放大
• 行高增大
• 段首缩进
• 图片居中
• 表格横向滚动
• 代码块自动换行
• 列表/引用/表格/代码区域取消段首缩进

注意：这个增强主要作用于：

• docs/books/imported_markdown/

也就是说，它重点优化的是“导入成 Markdown 后的阅读体验”，不是直接改 EPUB 原始排版引擎。

我推荐的使用方式

方案 A：直接读 EPUB 原文件

适合：

• 想尽量保持原书结构
• 想快速打开就看
• 需要目录、位置记忆、字体调节

使用插件：

• obsidian-epub-plugin

优点：

• 打开快
• 保留 EPUB 原内容结构
• 已确认支持连续滚动

局限：

• 中文排版强化能力有限
• 原书 CSS 比较脏时，显示质量受源文件影响更大

方案 B：导入成 Markdown 再读

适合：

• 想要真正上下滚动长文阅读
• 想强化中文排版稳定性
• 想做摘录、批注、链接、知识库整理

使用插件：

• epub-importer
• epub-reading-enhanced.css

优点：

• 阅读行为完全走 Obsidian 原生 Markdown 流
• 更适合连续滚动
• 更容易统一中文排版
• 更容易二次整理和长期维护

局限：

• 导入后不再是原始 EPUB 单文件模式
• 个别复杂图文书仍可能需要专项清理

当前社区插件登记

文件：

• E:\My Project\Atramenti-Console\codex\plugins\obsidian\data\.obsidian\community-plugins.json

当前已登记：

• obsidian-epub-plugin
• obsidian-annotator
• epub-importer

当前状态判定

文件级恢复与安装状态：已完成

已完成内容：

• 官方源码找回
• 本地编译成功
• 安装到当前 Vault
• 配置文件写入
• 中文排版片段添加并启用
• 历史恢复阶段曾使用独立 plugin-recovery 目录；当前仓库只保留已安装插件与现行配置

可见界面验证状态：未完成 / unverified

原因：

• 目前只完成了源码、编译产物、安装目录、配置文件和功能标记的核验
• 还没有拿到 Obsidian 界面中的实际截图证据来证明“插件面板已正常加载、书籍已可见、滚动效果已在界面中展示”

后续最值得做的两步

1. 在 Obsidian 里实际打开一个 .epub，确认 obsidian-epub-plugin 的滚动阅读是否正常
2. 任选一本 .epub 用 epub-importer 导入到 docs/books/imported_markdown，看中文排版效果是否已经达到你的预期

本次验证证据

截图证据：

• 历史恢复阶段截图路径未在当前仓库保留

验证结果分级：

• unverified

说明：

• 已实际拉起 E:\My Project\Atramenti-Console\codex\plugins\obsidian\app\obsidian\Obsidian.exe
• 已拿到桌面截图，能看到 Obsidian 窗口出现
• 但截图里还停留在 Vault 选择/启动界面，未进入到“插件列表 / EPUB 阅读页 / 导入后正文页”
• 因此不能把这次结果算作“已可见验证通过”
• 另外当前便携版 Obsidian 启动日志里还能看到 resources.pak、chrome_100_percent.pak 缺失提示，这也会影响进一步界面验证的可信度