PDF书签添加工具：三步为扫描版PDF快速生成智能导航目录

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

还在为一本300页的扫描版电子书翻不到想看的章节而抓狂吗？PDFdir是一款免费开源的PDF书签添加工具，只需一段目录文本，就能自动为你的PDF生成完整的导航大纲，从此告别一页页盲目翻找。

为什么你需要一个PDF导航书签工具？

先想想这些场景：下载了一本没有目录的PDF技术文档，老板催着要方案却找不到关键章节；买回一本扫描版学术专著，想引用某节内容却要前后翻几十页；整理个人电子书库时，每本书都要手动定位……

没有书签的PDF，就像没有索引的百科全书——内容都在，但你就是找不到。

PDFdir要解决的，正是这个"内容在、却难寻"的痛点。它的工作原理简单直接：把你在网上书店或豆瓣读书上复制的目录文本，自动转换为PDF标准的大纲（Outline）结构，写入文件后，你的阅读器左侧就会立刻出现可点击跳转的完整目录。

三大核心能力，让目录生成不再是难题

1. 智能解析：杂乱目录文本也能"看懂"

网上复制的目录格式五花八门：有页码、没页码、带圆点省略号、用括号括起来的页码……PDFdir内置了多套页码识别规则，能自动从每行文本中分离标题和页码，还能从（12）、【23】、《45》等各式括号中正确提取页数。核心解析逻辑位于src/convert.py，无论文本来自亚马逊商品描述还是豆瓣读书页面，都能准确转换。

2. 六层目录结构：复杂书籍轻松驾驭

单层书签只能满足简单文档，而PDFdir支持最多6级目录层级。无论是"章→节→小节"的教科书，还是多级编号的技术手册、法律条文汇编，都能构建出层次分明的大纲树。默认内置了"第1章""1.1""1.1.1"等常见格式的匹配规则，开箱即用。

3. 双模式操作：图形界面与命令行任选

• 图形界面模式（python run_gui.py）：实时预览目录树，双击条目直接改标题、改页码，还能通过拖拽调整层级关系
• 命令行模式（python run_cli.py）：适合批量处理，无图形环境也能运行，配合脚本可一次处理大量PDF

三步上手：给PDF加上导航书签

整个过程比你想象的要快：

第一步：准备材料。准备一个PDF文件，再从网上书店或豆瓣读书复制它的目录文本，格式就是"标题+页码"逐行排列，例如：

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

第二步：导入工具。运行python run_gui.py打开界面，在"PDF文件路径"处填入或选择PDF，把目录文本粘贴到"目录文本"框中，目录树会实时自动生成。

第三步：微调并写入。检查生成的目录结构，必要时双击修改标题或页码、拖拽调整层级，然后点击"写入"按钮。片刻之后，原PDF同目录下就会生成一份"原文件名_new.pdf"，打开它，完整的导航书签已经在左侧等着你了。

💡 依赖环境很简单：Python + PyQt5 + PyPDF，pip install -r requirements.txt即可搞定。

进阶玩法：用正则表达式定制解析规则

如果你处理的目录格式比较特殊，命令行模式提供了充分的定制空间。通过--l0到--l5六个参数，你可以为每一级目录自定义匹配规则：

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

正则表达式可以理解为"更强大的通配符"：\d匹配数字、\w匹配字符、\*表示任意多次。比如"第\d*章"就能同时匹配"第1章"和"第100章"。想更省事的话，图形界面的"层级正则"输入框也能完成同样的配置。

谁最需要这个工具？

• 学生与研究人员：扫描版论文、教材、学术专著是重灾区，添加上书签后文献查阅效率直接翻倍
• 职场人士：企业培训材料、操作手册、技术文档统一规范化，同事找信息的时间大幅缩短
• 开发者：命令行模式便于集成到自动化流程中，批量处理整个文件夹的PDF；同时项目源码结构清晰（核心模块在src/pdf/），方便二次开发

常见问题

Q：目录里的页码和PDF实际页数对不上怎么办？A：可以使用"页数偏移"（offset）参数整体修正；非正文部分（如序言、目录页）通常没有页码，程序会默认链接到第一页，可在界面中手动调整。

Q：目录文本里有些行没有页码？A：这类条目会被自动链接到上一个有页码的标题页，保证导航仍然可用。

Q：能处理英文PDF吗？A：可以。将语言包放置到程序目录后，通过菜单"语言→English"即可切换英文界面。

现在就给你的PDF装上传送门

想想那些躺在硬盘里、因为没有目录而很少被翻开的电子书吧。有了PDFdir，几分钟就能让它们变成"可随手检索"的专业文档。与其继续忍受无目的翻页，不如现在就动手——打开工具，粘贴目录，点击写入，让每一本PDF都拥有自己的导航地图。

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