[开源] Mktero：在 Zotero 里把 PDF 转成可重排的 Markdown 阅读

最近做了一个 Zotero 插件 Mktero ，想分享出来找一些真实用户测试。

项目地址：

https://github.com/tenglvjun/mktero

安装包：

https://github.com/tenglvjun/mktero/releases/latest

为什么做这个

我平时在 Zotero 里读论文时，经常遇到多栏排版、公式、表格和图片混在一起，窗口缩小时阅读体验不太好。

所以做了 Mktero：把 Zotero 中的本地 PDF 交给 MinerU 解析，再将返回的 Markdown 、公式、表格和图片放到一个新的 Zotero 标签页中阅读。

它不是要替代原始 PDF ，而是提供一个更适合连续阅读和内容浏览的视图。需要核对版式时，仍然可以随时返回 PDF 。

目前支持

• Zotero 7 、8 和 9


• 从 PDF 阅读器工具栏或文库右键菜单打开


• Markdown 重排阅读


• 公式、表格、图片和代码块渲染


• 自动生成文章目录


• 引用、图表悬停预览和点击跳转


• 图片全屏预览、缩放和拖动


• 显示已有的 Zotero PDF 高亮和下划线


• 从 Markdown 划词创建高亮或笔记


• 将能够可靠定位的标注同步回 Zotero PDF


• 缓存 Markdown 和图片，重复打开时不再上传


• 恢复尚未完成的 MinerU 任务，避免重复上传 PDF


• 英文和简体中文界面

安装和使用

1. 从 GitHub Releases 下载 mktero-<version>.xpi


2. 在 Zotero 中打开“工具 -> 插件”


3. 点击右上角齿轮，选择 Install Add-on From File...


4. 安装后进入“设置 -> Mktero”


5. 配置 MinerU API Token


6. 打开 PDF ，点击阅读器工具栏中的文件图标

MinerU Token 可以在这里获取：

https://mineru.net/apiManage/token

当前版本是 v0.2.3 。

隐私说明

缓存未命中时，Mktero 会把完整 PDF 上传到 MinerU 解析，因此不建议处理不适合上传第三方服务的敏感或保密文件。

MinerU Token 、转换后的 Markdown 和图片缓存在本地 Zotero 配置目录中，目前都没有加密。

Zotero 标注不会发送给 MinerU ，也不会放入 Markdown 缓存。

更完整的隐私和缓存说明在 README 中。

当前限制

• 只支持已经下载到本机的 PDF 附件


• Markdown 文档本身是只读视图


• OCR 和版面解析质量取决于 MinerU


• PDF 文本层与 MinerU 结果差异较大时，部分标注可能无法匹配


• 暂时不显示图片、区域、手写和独立便签类 PDF 标注


• 文件大小、页数和额度限制由 MinerU 决定

技术实现

插件使用原生 JavaScript 和 ES Modules 开发，通过 esbuild 打包为适用于 Firefox 115/Zotero 环境的 IIFE 。

Markdown 阅读器基于 CodeMirror 6 ，公式使用 KaTeX 渲染。插件包含 Markdown 安全处理、结果压缩包路径检查、资源大小限制、本地缓存以及 Zotero 生命周期清理。

项目采用 MIT License 。

想收集的反馈

目前最想确认的不是继续堆功能，而是首次使用流程是否顺畅：

• XPI 是否能正常安装


• MinerU Token 是否容易配置


• 第一次转换是否能成功


• 哪类 PDF 的解析效果不好


• 公式、表格、图片和引用的阅读体验
  -