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

tenglvjun

最近做了一个 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

英文和简体中文界面

安装和使用

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

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

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

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

配置 MinerU API Token

打开 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 的解析效果不好

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