把 300 页扫描 PDF 变成可跳转的电子书：PDFdir 书签工具实测

【免费下载链接】pdfdirPDF导航（大纲/目录）添加工具项目地址: https://gitcode.com/gh_mirrors/pd/pdfdir

深夜十一点，历史系研究生小林在整理新下载的三百页扫描版论文集，想找到某篇参考文献，只能一页页地翻。这种时刻很多人经历过：PDF 导航书签的缺失，让电子阅读退回纸质时代。开源工具 PDFdir 正是解决这个问题的——它根据你提供的目录文本，自动为 PDF 生成多级导航书签（大纲），把翻页检索变成一键跳转。

没有书签的 PDF，正在偷走你的时间

一次翻页找章节平均耗时 40 秒，一天查 10 次就是近 7 分钟，一个学期下来接近 10 个小时——这还只是一本书。把视角放大到工作流，问题更严重：资料库里有几百本无书签 PDF 的人，检索时间成本是资料量的线性函数。PDFdir 的价值不在于"加了个书签"，而在于把这种隐性损耗一次性清零。

这套工具如何融入你的工作流

PDFdir 的思路很朴素：目录文本你有，PDF 你也有，它负责把两者连接起来。目录文本从哪来？亚马逊商品描述、豆瓣读书页面、PDF 自带的目录页，复制粘贴即可，每行就是"标题+页码"：

前言 1 第1章 社会心理学导论 2 第2章 社会中的自我 32

拿到文本后，PDFdir 会自动识别页码、构建层级。它支持最多 6 级目录结构，学术专著"编→章→节→小节"的四层嵌套也能完整保留。没有页码的行也不怕，工具会自动让它继承上一条已定位标题的页码。

如果只依赖目录文本，你只有一种用法；搭配正则表达式，你就有了一整套定制能力。核心解析逻辑在 src/pdfdirectory.py 与 src/convert.py，默认规则按 "1."、"1.1."、"1.1.1." 这样的编号识别层级，遇到特殊排版时自己改规则即可。

从一行命令到批量处理

最小可用案例：一条命令生成书签

先准备两个文件：book.pdf和toc.txt（目录文本），然后运行：

python run_cli.py book.pdf toc.txt

几十秒后，原目录下会生成book_new.pdf，打开左侧栏，完整的可点击目录就在那里。这条命令来自命令行入口 run_cli.py，只需 Python 环境，不依赖任何图形界面。

进阶用法：用正则精确识别章节层级

当目录文本的编号风格不统一时，可以逐级指定匹配规则。比如用--l0匹配"第X章"、--l1匹配"X.Y"：

python run_cli.py book.pdf toc.txt --l0 "第\d+章" --l1 "\d+\.\d+"

\d代表数字，+表示至少一位，这段正则的意思是"第"后面跟一位或多位数字再接"章"。命令入口的--help会列出全部参数，包括--offset页码偏移量——当正文页码和 PDF 实际页码错位时，这是最常用的修正手段。正则规则的可视化编辑与实时预览，则在图形界面 src/gui/main.py 中提供。

批量场景：循环处理整个文件夹

单本书搞定了，整个资料库怎么办？命令行天然适合脚本化，一段简单的循环就能为文件夹里所有 PDF 批量生成书签：

for f in *.pdf; do python run_cli.py "$f" "${f%.pdf}.txt"; done

书签的写入底层由 src/pdf/pdf.py 完成，依赖 pypdf 而非付费库，这也是它能跨 Windows、macOS、Linux 运行的原因。

改造前后，阅读体验的差异

改造前：打开 PDF，面对一片空白的大纲栏，靠记忆和猜测定位章节，翻错页、看串行是常态。改造后：大纲栏里"编—章—节"层次分明，点一下直接跳到目标页，索引、引注、复习都变成秒级操作。最直观的感受是——这本 PDF 终于"像一本书"了，而不是一沓图片的堆叠。

适合谁，以及它的诚实边界

如果你符合下面任一情况，PDFdir 值得一试：

• 经常阅读扫描版书籍、论文，需要频繁跳转定位
• 管理着大量无书签的电子文档资料库
• 想为团队培训材料、操作手册统一补充导航

也请了解它的两个已知局限：一是序言、目录等非正文部分往往不标页码或用独立页码，这类条目会默认链接到第一页，需要在界面中手动微调；二是正文中没标页码的目录行，会沿用上一条有页码标题的位置。这两点在 readme.md 中都有说明，属于可预期、可修正的边界，而不是黑箱。

欢迎来仓库聊聊你的使用场景

PDFdir 是我在整理自己的电子书库时发现的小工具，代码量不大、逻辑直白，适合当作学习 PDF 处理的参考，也适合直接拿来解决实际问题。如果你有独特的目录排版、批量处理需求，或者发现了新的边界情况，欢迎到仓库提 issue 或留言讨论——工具是死的，使用场景是活的，你的反馈也许就是下一个版本的方向。

【免费下载链接】pdfdirPDF导航（大纲/目录）添加工具项目地址: https://gitcode.com/gh_mirrors/pd/pdfdir