Obsidian PDF++ 完整指南：把 PDF 高亮变成 Markdown，标注永不丢失
【免费下载链接】obsidian-pdf-plusPDF++: the most Obsidian-native PDF annotation & viewing tool ever. Comes with optional Vim keybindings.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-pdf-plus
读论文时想在 Obsidian 里划重点，内置查看器却只能看、不能标？PDF++ 的思路是：把标注直接做进你的 Markdown 笔记里。粘贴一行链接，页面上的文字就自动高亮，插件哪天停更，标注也照样读得出来。
一句话说清它是什么
PDF++ 是一个 Obsidian 社区插件，免费，桌面和移动端都能用。它给在知识库里读 PDF 的人解决一个老问题：标注到底存在哪。
多数标注插件把结果写进独立 JSON 文件或 PDF 内部，工具一失效，标注跟着遭殃。PDF++ 反过来，标注就是笔记里的普通文本链接，只要 Obsidian 还在，你的批注永远是你的。
核心思路：贴便签，而不是画记号
打个比方。JSON 式插件相当于用记号笔直接画在墙上，颜料混进墙体，墙一拆什么都没了。PDF++ 相当于把想法写在便签上、贴到墙上——墙拆了，便签还是你的，想贴到哪页就贴到哪页。
具体到使用：你选中一段文字，复制出的是标准 Obsidian 链接，形如[[file.pdf#page=1&selection=4,0,5,20&color=red]]。它不改变 PDF 文件本身，只是让查看器把这段文字"渲染"成高亮。区别在哪，见下表：
| 维度 | 常见 JSON 式标注插件 | PDF++ |
|---|---|---|
| 标注存在哪 | 独立 JSON 文件或 PDF 内部 | 笔记里的 Markdown 文本 |
| 标注归谁 | 插件 | 你本人（纯文本） |
| 插件停更后 | 标注不可读或丢失 | 链接仍有效，仅失去高亮效果 |
| 与笔记的关系 | 平行存放，靠插件绑定 | 标注即链接，天然参与反链与搜索 |
从安装到第一次高亮
- 装插件：Obsidian 设置 → 社区插件 → 搜索 "PDF++"，安装并启用。
- 选文字：打开任意 PDF，用鼠标选中想标注的那句话。
- 复制带颜色的链接：点工具栏色板里某个颜色块，链接连颜色一起复制到剪贴板；也可给命令 "Copy link to selection or annotation" 绑定
Ctrl+Shift+C（macOS 为Cmd+Shift+C）。 - 粘进笔记：在任意笔记里粘贴，回到 PDF，那段文字已染上对应颜色。整个过程不到十秒。
功能地图：一次看懂能干什么
| 功能 | 解决什么问题 |
|---|---|
| 反向链接高亮 | 贴一条链接就多一处高亮，不产生额外文件 |
| 工具栏色板 | 一键复制带颜色参数的链接 |
Ctrl/Cmd+悬浮预览 | 不切标签页就能看到批注的笔记内容 |
| 反链按页过滤 + 悬浮同步 | 快速回顾"当前页我写过什么想法" |
| PDF 页面合成器 | 增删提取页面，全库相关链接自动修复 |
| 编辑大纲（书签） | 右键增删改，拖拽调整层级 |
| 编辑页码标签 | 修正印刷页码与实际页码的错位 |
| PDF 内部链接增强 | 内部跳转可预览、可返回、可复制成 Obsidian 链接 |
| PDF++ callouts | 笔记引用块与高亮同色，无需手写 CSS |
| 写回 PDF（实验） | 高亮在 Obsidian 之外也可见 |
| Vim 键位 | j/k滚动、提示键跳链接 |
每个功能都能在设置里单独开关，不用的可以直接关掉。
三个最值钱的用法深讲
1. 色板 + 颜色编码：给标注建立自己的语法
怎么用：在设置里注册 3–4 个颜色，比如黄色=重要概念、绿色=支持论据、蓝色=疑问。选中文字后点色板，复制出的链接自动带上&color=yellow这类参数（颜色名大小写不敏感，写RED也一样）。
有什么用：高亮颜色从此有含义，扫一眼 PDF 就知道每段批注的"性质"。不想用参数也行，设置里可指定一个默认高亮颜色，全库统一。
小技巧：复制格式由{{...}}模板控制，能改成"文件名+页码"、包一层引用块，或配置"无选中文字时复制整页链接"，一个设置覆盖多种场景。
2.Ctrl/Cmd+ 悬浮：在 PDF 和笔记间架一条双向通道
怎么用：鼠标停在高亮文字上，同时按住Ctrl（macOS 为Cmd），弹出对应笔记的预览浮窗；设置里可改为直接打开笔记。双击高亮文字则直接跳转到那篇笔记。
有什么用：读 PDF 时不用来回切标签页，批注的上下文悬停即得。
小技巧：把这一招和反链面板的"悬浮同步"一起开——鼠标移到 PDF 高亮上，面板里对应条目同步点亮，反向移动也一样。小屏笔记本再配 Hover Editor，浮窗里直接编辑笔记，体验很顺。
3. 反向链接面板：把"链接列表"变成标注总览
怎么用：开启"按页过滤"，面板只显示指向当前页的批注；开启悬浮同步，鼠标扫过哪条，PDF 上哪处亮。
有什么用：读论文时想确认"这页我到底记了哪几条"，低头扫面板即可，不用翻笔记。
小技巧：配合 "PDF++ callouts" 生成与高亮同色的引用块，批注块的配色和高亮完全一致；再装上 Better Search Views，这个面板能做成接近文献管理软件的标注视图。
进阶与插件搭配
管理 PDF 本身：
- 页面合成器：Note Composer 的 PDF 版，命令增、插、删、提取页面，删页后全库指向它的相关链接自动更新，不会留一堆死链；
- 大纲与页码标签：右键大纲增删改书签，拖拽条目即可改层级；印刷页码错位时改页码标签，跳转引用立刻准确；
- 写回 PDF（实验功能）：把标注真正写进文件，Obsidian 外也能看到。官方明确提醒：先备份，作者不对数据损坏负责；
- Vim 键位：完整 Vim 风格按键，
j/k滚动、提示键模式跳链接，实现在 src/vim/ 目录。
组队建议：Hover Editor 让浮窗可编辑，省掉切标签页；Style Settings 承载部分显示开关（如嵌入 PDF 隐藏工具栏）；Better Search Views 把反链面板升级成标注视图。
要避开的组合：Close Similar Tabs。它改动 Obsidian 内部逻辑，与 PDF++ 部分功能冲突，官方明确不建议同用。
桌面端还有个实用项：可让 PDF 链接交给系统默认外部应用打开，并让外部应用与 Obsidian 同步聚焦同一份文件。
原理速览：它站在什么底座上
进阶读者可以了解一句：PDF++ 没有另造阅读器，它站在 Obsidian 原生查看器背后的 PDF.js 渲染引擎上，用 monkey-around（一个补丁库，给已有函数"打温和的补丁"）扩展原生行为——这也是它能增强而非替代原生阅读器的原因。
标注核心逻辑集中在 src/lib/highlights/ 目录，对 PDF 查看器的扩展在 src/patchers/pdf-view.ts。想二次开发，直接克隆仓库：
git clone https://gitcode.com/gh_mirrors/ob/obsidian-pdf-plus避坑清单：四个高频问题
Q：高亮不显示？依次检查：插件已启用且对应功能开关打开；链接带&color=参数或设置了默认高亮颜色；极少数 PDF 文件本身限制样式覆盖。都确认过还无效，就运行命令 "Reload app without saving" 重启，这是官方首推的万能排查法。
Q：复制快捷键没反应？两个复制命令无法从命令面板触发，必须在快捷键设置里手动绑键。另外确认输入法没有抢占这个组合键。
Q：Obsidian 升级后插件失效？PDF++ 依赖较多私有 API，大版本更新时可能暂时失效。且未来更新会要求 Obsidian 1.6.5 及以上版本，建议保持自动更新。好消息是标注是纯 Markdown，最坏情况只是失去高亮效果，数据本体不丢。
Q：Android 上行为异常？先更新 "Android System WebView"；Android 7–9 用户改更新 Chrome 应用，多数移动端问题靠这两步解决。
行动清单：今天就能做的 5 步
- 安装并启用 PDF++；
- 在设置里注册 3 个高亮颜色，定下你的颜色编码；
- 给 "Copy link to selection or annotation" 绑定
Ctrl+Shift+C； - 打开一份常读的 PDF，完成第一次带颜色的高亮并粘进笔记；
- 在反链面板开启"按页过滤"和"悬浮同步"。
现在就打开你读得最多的那份 PDF，选中第一句关键句，把高亮贴进你的笔记里。
【免费下载链接】obsidian-pdf-plusPDF++: the most Obsidian-native PDF annotation & viewing tool ever. Comes with optional Vim keybindings.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-pdf-plus
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
