全部项目

文档与学习资料 / 原创

MineruCustom

PDF 转完 Markdown,把弄丢的脚注和页码捡回来。

我在这项目里干了啥

MinerU 后处理脚本与页码回填

用到的技术栈

Python / MinerU

MineruCustom:接在 MinerU 解析后面跑一道后处理,把转换时被当成杂讯丢掉的脚注和原始页码重新塞回正文。的原理示意图
用 SVG 画的原理示意图(不是软件截图,主要为了把底层是怎么跑的讲清楚)。

为什么做这个

用工具把 PDF 教材和文献转成 Markdown 时,正文虽然提取出来了,但页脚的注释和原书页码经常被一刀切掉。看专业资料尤其是法学文献,没了脚注和页码,想回头查原文简直是大海捞针。

我是怎么搞定的

没有重造 PDF 解析轮子,而是顺着 MinerU 跑出来的中间数据往下接。写了一层后处理,把被过滤掉的脚注重新捞回来,再把原书的页码标记插回对应的段落旁边。

现在做成了什么样

做成了可以直接串进转换流程的 Python 小工具。跑完之后,Markdown 里既有干净的正文,也保留了能一路追回原书哪一页、哪条注释的线索。

提前说清楚的局限

它能找回多少,取决于 MinerU 的中间结果里还留着多少线索。而且找回页码只是方便翻书,真要引用或下结论,还得自己去核对原件。

做的时候怎么权衡的

站在现成工具肩膀上

MinerU 拆版面已经做得挺好,我只管在它后面写脚本,把漏掉的脚注和页码补齐。

读到哪都能翻回原书

把原页码直接写进 Markdown 里,读笔记看到存疑的地方,马上知道去翻 PDF 第几页。

给后面的笔记流程喂好料

源头资料把出处留全了,后面再用 AI 提炼卡片或做摘要,才不会变成无头公案。

顺便看看下一个Xaihi

新功能都塞进插件里,别把主程序改得一团乱。