PDF Mark Link

by chenyemanbu
5
4
3
2
1
Score: 50/100
New Plugin

Description

在 Obsidian 中高亮、圈选 PDF,写分析批注并双向链接笔记。Chinese PDF annotation and note linking.

Reviews

No reviews yet.

Stats

0
stars
downloads
0
forks
0
days
0
days
0
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
4
commits

README file from

Github

PDF 标注与笔记链接,简体中文操作界面。

在 Obsidian 的 PDF 阅读器里高亮文字、圈选曲线、写分析批注,并把对应位置关联到已有笔记。界面为简体中文。

PDF Mark Link adds Chinese-language annotation controls to Obsidian's built-in PDF viewer. Highlight text, circle or frame figures, add comments, and navigate between PDF annotations and Markdown notes.

使用方法

打开知识库内的 PDF,顶部会出现五个按钮。

按钮 用途
只标注 给选区添加高亮或形状标记,并填写可选的分析批注
关联笔记 搜索已有笔记,在笔记末尾添加返回 PDF 对应标注的链接
圈选 拖出圆形或椭圆,标记曲线、公式、图片中的位置
框选 拖出矩形区域
管理标注 按页查看本插件创建的标注,并逐条删除

先选中文字,或点击「圈选」「框选」后拖动,再选择「只标注」或「关联笔记」。按 Esc 可以取消绘制。

圈选关联笔记时,可以填写分析。该分析同时保存为 PDF 批注和笔记末尾的文字。点击 PDF 圈旁的链接图标打开关联笔记,点击笔记中的链接跳回 PDF 的相应位置。

点击 PDF 标记可以查看批注。删除标注时,关联笔记中的对应链接会改为 PDF 页码链接,笔记里的文字会保留。

安装

当前为准备提交社区目录的桌面版本。市场中的名称为 PDF Mark Link。

下载发布版的 main.js、manifest.json、styles.css,放进知识库的 .obsidian/plugins/pdf-mark-link/ 文件夹,然后在「设置 → 社区插件」中启用 PDF Mark Link。也可以解压安装 ZIP,把整个 pdf-mark-link 文件夹放进 .obsidian/plugins/。

更新前停用插件,替换上述三个文件后重新启用。

设备与兼容性

  • 最低版本为 Obsidian 1.15.1,已在 Windows 11 的 Obsidian 1.15.1 验证。
  • 构建文件采用浏览器 API,没有本机路径或 Node.js 运行时依赖,作为 Windows、macOS 和 Linux 桌面插件分发。macOS 和 Linux 尚未进行实机验收。
  • 目前仅提供桌面版本,手机和平板尚未适配。
  • PDF 选区定位和图标显示依赖 Obsidian 内部 PDF 阅读器的接口。Obsidian 更新后可能需要适配。
  • 功能针对 PDF 标签页。Markdown 中的普通 PNG/JPEG 图片、嵌入式 PDF 和白板尚未适配。
  • 本版提供新增批注和删除功能,修改已有批注可通过删除后重新标注完成。

数据与同步

标注以 PDF 的 Highlight、Square、Circle 标准批注写入原 PDF 文件。关联笔记使用 Markdown 链接,例如 [[手册.pdf#page=3&annotation=233R]]。

插件在本地读写知识库内的 PDF 和笔记。插件本身没有网络请求、遥测、云端账户或收费服务。安装和更新由 Obsidian 或用户管理。

换电脑时,需要同步 PDF、Markdown 笔记和安装插件。安装插件本身不会复制知识库内容。请先完成文件同步再继续编辑,同一份 PDF 的跨设备同时编辑由同步工具处理。

带有数字签名或加密保护的 PDF 不在当前验收范围。修改内容可能影响原文件签名。

从源码构建

需要 Node.js 22 或更新版本。

npm ci
npm test
npm run build

构建结果在 dist/。合并新版本到 main 后,发布工作流会为 manifest 中尚未发布的版本创建同名标签及 Release,例如 0.1.5,不加 v 前缀。

源代码、安装说明和许可证均属于本插件。依赖的许可证会写入构建后的 main.js 顶部和 THIRD_PARTY_NOTICES.md。

License

MIT. Copyright 2026 Flyboy.

PDF processing uses pdf-lib and its dependencies. Complete third-party licenses are included in each build.