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 划重点、写批注，又不想被"换工具、导数据、插件失效就全丢"折磨，那么今天要介绍的Obsidian PDF++ 插件就是为你准备的答案。它是目前最"Obsidian 原生"的 PDF 标注与阅读增强工具，核心思路只有一个：用纯 Markdown 反向链接做高亮，标注永远跟着你的笔记走，而不是锁死在某个软件里。这篇文章不堆代码，全程手把手带你从安装到进阶，读完就能上手。

先别急着装软件，看看你是不是也遇到这三个问题

你大概率经历过这样的场景：读一篇重要的 PDF 论文，看到关键段落想划个线、写两句想法，却发现 Obsidian 自带的阅读器只能看、不能标。于是你只好：

• 把 PDF 丢进另一个标注软件，标完再截图贴回笔记，来回切换很割裂；
• 用某些标注插件，结果标注被存成一大串看不懂的 JSON 文件，哪天插件停更，标注就跟着"陪葬"；
• 或者干脆放弃标注，读完就忘，知识全留在脑子里，等于白读。

这些痛点的共同根源是：标注没有真正长在 Obsidian 的知识体系里。而 PDF++ 选择了一条完全不同的路——它把你的高亮直接做成笔记里的 Markdown 链接。链接是 Obsidian 的"母语"，所以标注天然和笔记、反向链接、搜索融为一体，任何格式都能长期存活。

它和别的 PDF 标注工具到底差在哪？

市面上不是没有 PDF 标注方案，但 PDF++ 的三个特点，让它和它们有本质区别：

第一，标注是纯 Markdown，永不丢失。你在 PDF 里选一段文字，复制出来的是一段标准的 Obsidian 链接，比如[[论文.pdf#page=1&selection=4,0,5,20&color=red]]。就算插件某天停止维护，只要 Obsidian 还活着，这段链接依然是有效文本，你可以继续阅读、编辑、跳转。开发者原话是：他讨厌那种"扩展名是 .md、内容却根本不是 Markdown"的文件——PDF++ 坚持让标注回归纯文本。

第二，它是"增强"而不是"替代"。PDF++ 没有另起炉灶做一个新阅读器，而是在 Obsidian 原生 PDF 查看器的基础上叠加功能。你得到的是一套无缝集成的体验：原来的翻页、缩放、双页视图全都在，只是多了一堆顺手的好东西。它甚至允许你把标注功能整个关掉，只当一个纯阅读增强工具来用。

第三，一个 PDF 的标注可以分散在整个知识库。这是真正意义上的"Obsidian 原生标注"：论文 A 的批注可能出现在你的读书笔记里，也可能出现在某篇观点文章里，反向链接会帮你把它们全部找回来。

十分钟上手：从安装到第一次高亮

这一节全程可操作，跟着做就行。

第一步，安装插件。打开 Obsidian 的"社区插件市场"，搜索 "PDF++"，点安装再点启用即可。它完全免费，也支持移动端。想尝鲜测试版，可以用 BRAT 插件加载 beta 版本，不过新手建议先用稳定版。

第二步，打开一个 PDF 并选中文字。用 Obsidian 打开任意一份 PDF 文件，用鼠标选中你想标注的一句话或一段话。

第三步，让高亮出现。这里有两种常用姿势，任选其一：

1. 色板复制：选中文字后，PDF 阅读器工具栏会出现一排颜色色板，点一下某个颜色，链接就被自动复制到剪贴板，而且自动带上了颜色参数；
2. 快捷键复制：把"Copy link to selection or annotation"命令绑定为Ctrl+Shift+C（macOS 是Cmd+Shift+C），选中文字后按一下即可。

第四步，把链接粘进笔记。随便打开一篇笔记，粘贴。回到 PDF 再看，那段文字已经染上了对应颜色——高亮就这样生成了。整个过程不到十秒，而且你贴进笔记的每一处高亮，都会自动出现在 PDF 的反向链接面板里。

如果你连快捷键都懒得按，还有一个"懒人模式"：开启设置里的 "select text to copy" 选项后，每次在 PDF 里选中文字，链接都会自动复制，彻底解放双手。

高亮只是开始：颜色、回链与悬浮预览

第一次高亮成功后，你会发现标注系统远比想象中强大。

建立你的颜色编码体系。在插件设置里可以自由注册颜色，比如黄色代表"重要概念"、绿色代表"支持论据"、蓝色代表"疑问"、粉色代表"行动项"。链接里的&color=red这种参数就是颜色标记，大小写不敏感，写RED、rEd都行。你也可以不写颜色参数，统一使用设置的"默认高亮颜色"，保持整洁。

Ctrl/Cmd + 悬浮，一秒看懂上下文。鼠标悬停在 PDF 里的高亮文字上，同时按住Ctrl（macOS 为Cmd），会弹出对应笔记的预览浮窗；设置里也可以改成"直接打开笔记"。双击高亮文字，则直接跳到对应笔记。这意味着你的 PDF 和笔记之间形成了真正的双向通道，读 PDF 时不用切来切去。

反向链接面板升级成"标注总览"。你可以在反向链接面板里按当前页过滤，只看这一页有哪些笔记引用了它；还能开启"悬浮同步"——鼠标在 PDF 高亮上移动，面板里对应的笔记条目同步高亮，反之亦然。读论文时想快速查看"我这页写过什么想法"，低头扫一眼面板就行。

同色引用块（Callout）。想让笔记里的批注块和 PDF 高亮颜色一致？不用写任何 CSS，直接用 "PDF++ callouts" 功能就能生成与高亮同色的引用块，视觉上浑然一体。

连复制格式都能定制。设置里提供了模板系统，用{{...}}占位符可以自定义复制出来的链接格式，比如"文件名 + 页码"、嵌套在引用块里、或者纯链接不带说明文字。你甚至可以配置"没有选中文字时复制整页链接"，一个设置覆盖多种场景。

进阶玩法：把 PDF 当成能编辑的知识库

如果你不只是想标注，还想"管理"PDF 本身，PDF++ 的进阶功能会让你惊喜——这些在别的插件里几乎找不到。

• PDF 页面合成器：这是 Obsidian 核心插件"Note Composer"的 PDF 版。你可以通过命令添加、插入、删除或提取 PDF 页面，而且整个知识库里相关的链接会自动更新，不用担心删掉一页后链接全部失效。
• 编辑大纲（书签）：PDF 自带的目录/书签可以直接增删改，右键大纲就能操作，还能用拖拽把某个条目移动到另一条目之下，相当于给 PDF 重新整理目录。
• 编辑页码标签：当 PDF 的印刷页码和实际页码对不上时，可以手动修改页码标签，让跳转和引用更准确。
• PDF 内部链接增强：PDF 里自带的内部链接（比如参考文献跳转），现在支持Ctrl/Cmd + 悬浮弹出预览浮窗；打开"历史导航"后，点进内部链接再点返回箭头，会回到你之前的页面；右键还能把 PDF 内部链接复制成 Obsidian 链接贴进笔记，点击即可直达原位置。
• 直接写回 PDF（实验功能）：如果你希望高亮在 Obsidian 之外也能看到，可以开启"直接编辑 PDF"，把标注真正写入文件。注意这是实验性功能，官方明确提醒请先备份再用，作者不对数据损坏负责。日常使用，纯 Markdown 的背链高亮已经足够。
• Vim 键位彩蛋：Vim 用户有福了——插件自带完整的 Vim 键位支持，阅读时可以用熟悉的j/k滚动、用类似 Vim 的提示键跳转链接，相关实现代码在src/vim/目录下，设计灵感来自 CodeMirror Vim 和 Tridactyl。不喜欢就用默认鼠标操作，完全不冲突。

和其他插件组队，效果更佳

PDF++ 设计时就把"生态兼容"放在了重要位置，下面这几组搭配值得一试：

• Hover Editor（悬浮编辑）：配合使用后，点击 PDF 高亮预览浮窗，可以直接在浮窗里编辑笔记，不用切标签页，小屏笔记本尤其舒服；
• Style Settings（样式设置）：部分显示细节（比如嵌入 PDF 时隐藏工具栏）依赖它来开关；
• Better Search Views（增强搜索视图）：能把反向链接面板变成类似文献管理工具的标注视图，配合 PDF++ callouts 非常出片。

反过来，有一个插件要避开：Close Similar Tabs。它会改动 Obsidian 内部逻辑，和 PDF++ 的部分功能冲突，官方明确不建议同时使用。另外在桌面端，PDF++ 还支持把 PDF 链接用系统默认外部应用打开，甚至可以让外部应用与 Obsidian 同步聚焦同一份文件，适合习惯在专业阅读器里精读的朋友。

标注到底存哪里？背后其实很简单

进阶读者可能会好奇它的原理，这里点到为止。PDF++ 并没有发明什么黑科技，它的根基是 Obsidian 原生查看器背后的PDF.js 渲染引擎，再用 monkey-around 这个补丁库去"温和地"扩展原生能力——这也是它为什么能无缝增强而非替代原生阅读器。标注系统本身就是一个"反向链接高亮层"：笔记里每一条指向 PDF 的链接，渲染时就在 PDF 上生成对应高亮，核心逻辑集中在src/lib/highlights/目录；对 PDF 查看器的扩展在src/patchers/pdf-view.ts，工具栏相关代码在src/toolbar.ts，有兴趣可以按图索骥。如果你想从源码构建或二次开发，直接拉取仓库即可：

git clone https://gitcode.com/gh_mirrors/ob/obsidian-pdf-plus

常见问题自查清单

遇到问题别急，先按下面的顺序排查，大部分情况都能解决：

高亮不显示？

1. 确认插件已启用，且对应功能开关是打开状态；
2. 检查链接里是否带了&color=参数，或设置了默认高亮颜色；
3. 极少数 PDF 文件本身会限制样式覆盖；
4. 还不行就运行命令 "Reload app without saving" 重启 Obsidian，这是官方首推的万能排查法。

复制快捷键没反应？这两个复制命令比较特殊，无法从命令面板触发，必须在快捷键设置里手动给它们绑定按键。另外确认不是输入法抢占了组合键。

PDF 背景色、样式不生效？先确认插件里的主题适配选项已开启，再看相关样式是否依赖 Style Settings 插件，最后检查你的 CSS 片段是否正确启用。

Android 手机上异常？优先尝试更新"Android System WebView"；如果系统是 Android 7–9，则更新 Chrome 应用，大部分移动端问题都能靠这个解决。

升级 Obsidian 之前，你要知道的事

两个需要提前了解的提醒，帮你避免踩坑：

一是兼容性风险。PDF++ 为了做到原生级体验，依赖了不少 Obsidian 的私有 API，这意味着Obsidian 大版本更新时，插件存在暂时失效的可能。也正因为如此，开发者公开表达了希望这些功能未来被 Obsidian 官方原生支持。好消息是，你笔记里的标注是纯 Markdown，插件出问题损失的只是显示效果，数据本体永远安全。

二是版本要求。未来 PDF++ 的更新会要求 Obsidian 1.6.5 及以上版本，太旧的 Obsidian 会停留在旧版插件上，建议保持 Obsidian 自动更新。

从今天开始，让标注真正为你所用

到这里，你已经掌握了 PDF++ 的核心玩法。现在花五分钟做这几件事，就能立刻感受到变化：

1. 在社区插件市场安装并启用 PDF++；
2. 在设置里配置 3–4 个常用高亮颜色，建立自己的颜色编码；
3. 给"复制链接"命令绑定Ctrl+Shift+C快捷键；
4. 打开一份常读的 PDF，完成第一次带颜色的高亮并贴进笔记；
5. 在反向链接面板里打开"按页过滤"和"悬浮同步"，感受双向联动的威力。

从"选中文字"到"高亮进笔记"，全程不到五秒；标注从"锁在某个软件里"变成"长在你的知识库里"。这就是 Obsidian 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