AXL Light 是一个专为 Obsidian 打造的高亮与批注插件,它的最大亮点是“非侵入式”——不会修改原始 Markdown 或 PDF 文件,而是将所有高亮与批注数据独立存储在 .obsidian-annotations/ 文件夹中,让笔记既保持干净,又能随时恢复和导出。
插件核心功能
- 高亮覆盖:支持 Markdown 的 Live Preview、Source Mode、Reading View,以及 PDF 文件。
- 浮动工具栏:六种颜色选择,快速添加高亮、粘性便签、复制或打开批注总览。
- 粘性便签:右侧便签栏支持 Markdown 渲染,便签可内联编辑。
- 批注总览:支持搜索、颜色过滤、排序、跳转、删除、导出。
- 数据存储:所有批注存储在 JSON 文件中,原始笔记文件保持不变。
安装方式
- BRAT 安装:通过 Obsidian 的 BRAT 插件添加测试版,输入仓库地址即可启用。
- 快速安装:
- macOS/Linux:运行
install.sh 脚本,指定 Vault 路径。 - Windows:运行 PowerShell 脚本,自动下载并安装。
- 手动安装:下载最新 release 的
main.js、manifest.json、styles.css,放入 vault/.obsidian/plugins/axl-light/。
使用场景
- 学术研究:在 PDF 文献中高亮关键段落并添加批注。
- 知识管理:在 Markdown 笔记中用不同颜色区分重点。
- 工作文档:快速标记待办事项或重点信息,便于团队协作。
highlight-with-axl-light.png
与其他插件的差异
- 非侵入式设计:不同于直接修改文件的插件,AXL Light 保证原始笔记文件始终干净。
- PDF 支持:相比部分仅支持 Markdown 的插件,它能在 Obsidian 内对 PDF 进行高亮与批注。
- 轻量化:插件体积小,性能优化好,不会拖慢 Obsidian。
sticky-notes-overview.png
潜在限制与风险
- 主题兼容性:部分 Obsidian 主题或插件可能影响高亮定位。
- PDF 特殊布局:旋转页面或复杂 PDF 可能导致锚点偏移。
- 大规模批注:目前侧边栏渲染大量批注时性能有限,未来计划支持虚拟滚动。
总结
AXL Light 是一款 轻量、优雅、非侵入式 的 Obsidian 高亮插件,特别适合需要在 Markdown 与 PDF 中做批注的用户。它的设计理念是“保持笔记干净,同时让批注更强大”,对于追求极简与高效的知识管理者来说,值得安装尝试。