三步为扫描版PDF添加导航书签：免费开源工具pdfdir快速上手指南

三步为扫描版PDF添加导航书签：免费开源工具pdfdir快速上手指南

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

你有没有遇到过这种尴尬：好不容易下载了一本300页的扫描版电子书，想跳到第5章，却只能靠滚轮一页一页翻；想回头确认某个知识点，记不住页码就只能凭感觉乱点，阅读体验直接打回原形。pdfdir，一款免费的PDF导航书签添加工具，专治这种"目录缺失"的顽疾——你只需要把已有的目录文本粘贴进去，它就能自动为PDF生成可点击的导航大纲，几分钟让老旧的扫描件重获"电子目录"。

30秒看懂：pdfdir能为你带来什么

pdfdir上手的具体步骤：从拿到PDF到导出新文件

第一步：准备PDF和目录文本。目录文本的格式非常简单，每行就是"标题+页码"，例如：

第1章 社会心理学导论 2 第2章 社会中的自我 32 第3章 社会信念与判断 58

这部分内容可以直接从网上书店的商品描述、图书介绍网站的目录页复制，不需要任何手工整理。

第二步：导入并预览目录树。在项目目录执行python run_gui.py打开图形界面，选择PDF文件、粘贴目录文本，左侧会立刻生成一棵目录树。解析逻辑由src/convert.py完成，它会自动识别行尾的数字作为页码，并把带缩进或编号规律的标题归入正确的层级。

第三步：微调后一键写入。双击任意条目即可修改标题或页码，拖拽条目可改变上下级关系；确认无误后点击"写入"按钮，稍候片刻，原文件同目录下就会出现"原文件名_new.pdf"，打开后左侧大纲已完整可用。

【此处建议插入：pdfdir主界面截图，画面应包含目录文本输入区、页码偏移设置和目录树预览区】

进阶玩法：老手才知道的三个技巧

1. 用正则表达式精确控制层级。命令行模式下，你可以为每一级目录指定匹配规则，例如：

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

白话解释：告诉工具"第X章"算一级标题、"X.Y"算二级标题，识别更精准。

2. 用页码偏移修正"另起一套"的页码。很多书的序言、目录使用独立的页码体系，通过--offset参数或界面上的偏移输入框，可以一次性校正所有书签的跳转位置。

3. 保留已有目录、修复乱序页码。在"选项"菜单里勾选"保留已有目录"，新书签会与旧大纲合并；勾选"修复乱序页码"则能应对目录文本中页码非递增的情况。这两项是许多同类工具不具备的细节能力。

谁在用它？一张表对号入座

扫描版PDF添加目录书签的避坑要点

问：生成的页码跳得不准怎么办？答：非正文部分（序言、目录页）通常没有页码或使用独立页码，工具默认将它们链接到第一页，你可以在目录树里双击手动修正，或先用--offset整体校正。

问：目录文本里有的行没写页码？答：这类条目会自动继承上一条有页码的标题位置，通常不影响使用；若发现跳转异常，补上页码再重新生成即可。

问：英文环境能用吗？答：可以。把language/en.qm放到程序同目录，点击菜单"语言→English"即可切换英文界面。

问：不想用图形界面可以吗？答：完全可以，run_cli.py不依赖Qt环境，一条命令完成添加，适合无桌面的服务器或批量自动化场景。

写在最后：现在就去试试

pdfdir的价值一句话就能说清：把"复制的目录文本"变成"PDF里可点击的大纲"，全程不超过三分钟，而且完全免费、跨平台。想立刻体验的话，克隆仓库后安装依赖（pip install -r requirements.txt）即可运行：

git clone https://gitcode.com/gh_mirrors/pd/pdfdir

下一次再遇到没有导航的扫描版电子书，别再一页页硬翻了——给pdfdir三分钟，它还你一个想跳哪就跳哪的阅读体验。

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