Highlights to Obsidian

Highlights to Obsidian：将 Calibre 高亮同步到 Obsidian 的利器。

本项目是基于原有开源项目二次开发，添加新的功能。

---

下载链接：

highlights-to-obsidian-1.5.0.zip

---

前言

作为一个深度阅读爱好者，我习惯使用 Calibre 管理电子书，同时用 Obsidian 做笔记。长期以来，我一直面临一个痛点：在 Calibre 中阅读时做的高亮和批注，需要手动复制到 Obsidian 中整理，这个过程既繁琐又容易遗漏。

于是，Highlights to Obsidian 插件诞生了。它能将 Calibre 中的高亮和笔记一键同步到 Obsidian，让你的阅读笔记管理变得前所未有的高效。

核心功能

1. 两种发送模式

插件提供两种发送模式，满足不同使用场景：

URI 模式

• 通过 Obsidian 的 URI 协议发送笔记
• 需要 Obsidian 正在运行
• 每次发送会切换到 Obsidian 窗口
• 仅支持新建笔记，无法追加内容

Direct Write 模式（推荐）

• 直接写入 Obsidian 库文件
• 无需打开 Obsidian，后台静默写入
• 支持追加/前置内容到现有笔记
• 适合整书精读、多次高亮汇总

2. 灵活的模板系统

支持自定义笔记格式，包括：

• 笔记标题格式
• 高亮正文格式
• 无批注高亮的专用格式
• 笔记头部模板（仅新建笔记时添加一次）

模板支持丰富的变量，如 {title}（书名）、{authors}（作者）、{chapter}（章节）、{blockquote}（引用块）、{notes_quoted}（批注）等。

3. 智能排序

支持按多种维度对高亮进行排序：

• location：按书籍中的位置排序（推荐）
• timestamp：按高亮时间排序
• chapter：按章节排序
• date / time：按日期/时间排序

4. 一键跳转原文

每条高亮都包含指向 Calibre 原文的链接，点击即可跳转到书籍对应位置，方便回顾上下文。

使用场景

场景一：整书精读

阅读一本专业书籍时，边读边高亮、做批注。使用 Direct Write 模式，所有高亮自动追加到同一笔记中，按位置排序，形成完整的读书笔记。

场景二：快速摘录

阅读小说或休闲读物时，遇到精彩段落一键高亮发送，无需额外操作，笔记自动归档到 Obsidian。

场景三：团队协作

使用 Web 用户功能，可以区分不同用户的高亮，适合团队共读一本书的场景。

快速上手

安装

1. 下载插件 ZIP 包。
2. 在 Calibre 中选择「首选项 → 插件 → 从文件加载插件」
3. 选择下载的 ZIP 文件安装
4. 重启 Calibre

配置

1. 点击工具栏的插件图标，选择「Open Configuration」
2. 在「Vault & Direct Write」选项卡中：
   • 填写 Obsidian 库的绝对路径
   • 勾选「Enable direct write into vault」
3. 在「Formatting」选项卡中自定义笔记格式（可选）

使用

1. 在 Calibre 阅读器中选择高亮文本
2. 添加批注（可选）
3. 点击插件图标，选择发送方式：
   • 「Send all highlights」：发送所有高亮
   • 「Send new highlights」：仅发送新高亮
   • 「Send selected highlights」：发送选中的高亮

进阶技巧

自定义笔记格式

默认模板已经足够好用，但你也可以根据个人喜好定制：

## {chapter} | {localdate}

> [!quote] 原文
{blockquote}

**我的思考**：{notes}

利用笔记头部模板

笔记头部模板只会在新建笔记时添加一次，适合放置 YAML front matter：

---
tags: [读书笔记, {title}]
book: 《{title}》
author: {authors_str}
---

批量发送与时间过滤

「Send new highlights」功能会记住上次发送时间，只发送之后新增的高亮，避免重复发送。

结语

Highlights to Obsidian 让 Calibre 和 Obsidian 实现了无缝衔接，让阅读笔记的管理变得简单高效。如果你也是 Calibre + Obsidian 用户，不妨试试这个插件，相信它会成为你阅读工作流中不可或缺的一环。

项目地址：GitHub

欢迎反馈问题和建议！