[{"_1":2,"_162":-5,"_163":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_140":141},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_84":-5,"_85":86,"_131":-5,"_132":11,"_133":17,"_134":11,"_135":-5,"_136":11,"_137":-5,"_138":139},"canonicalUrl","https://hub.docker.com/r/xeden3/pdfbookmarkmaker/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","xeden3","reponame","pdfbookmarkmaker","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":51,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":70,"_75":11,"_76":77,"_81":29,"_82":83},"categories",[],"content_types",[40],"image","date_registered","2026-04-27T06:36:06.351593Z","description","","is_private","last_updated","2026-05-06T16:00:19.627128Z","last_modified","2026-04-27T07:04:28.920753Z","media_types",[52],"application/vnd.oci.image.index.v1+json","name","pull_count",160,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# PdfBookmarkMaker\n\n根据 Markdown 标题结构自动为 PDF 添加书签的 Docker 工具。\n\n## 功能特性\n\n- 自动解析 Markdown 文件的标题层级（# 到 ####）\n- 智能匹配 PDF 中的标题位置（多级匹配策略）\n- 支持中英文混合文本处理\n- 自动处理中英文/数字间的空格\n- 支持中文 Unicode 变体字统一（200+ 种变体汉字）\n- 可选生成标题页（支持 HTML 样式）\n- 批量处理目录下所有 PDF 文件\n- 层级书签结构维护\n\n## 目录结构\n\n```\nPdfBookmarkMakerDocker/\n├── make_bookmarks.py # 核心 Python 脚本\n├── Dockerfile # Docker 镜像配置\n├── entrypoint.sh # Docker 入口脚本\n└── README.md # 项目文档\n```\n\n## 快速开始\n\n### 方式一：直接拉取镜像（推荐）\n\n如果不想自行构建，可以直接从 Docker Hub 拉取预构建的镜像：\n\n```bash\n# 拉取最新版本\ndocker pull xeden3/pdfbookmarkmaker:v1.0\n```\n\n然后直接运行（无需构建）：\n\n```bash\ndocker run --rm \\\n -v ./:/input \\\n -v ./output:/output \\\n xeden3/pdfbookmarkmaker:v1.0\n```\n\n### 3. 运行方式二：自行构建镜像\n\n如果需要自定义或修改代码，可以从源码构建：\n\n#### 1. 构建 Docker 镜像\n\n```bash\ndocker build -t xeden3/pdfbookmarkmaker:v1.1 .\n```\n\n### 2. 准备文件\n\n在当前目录准备以下文件：\n\n```\n当前目录/\n├── input/ # 输入目录\n│ ├── document.pdf # PDF 文件\n│ └── document.md # 对应的 Markdown 文件\n└── output/ # 输出目录（会自动创建）\n```\n\n### 3. 运行\n\n```bash\ndocker run --rm \\\n -v ./:/input \\\n -v ./output:/output \\\n xeden3/pdfbookmarkmaker:v1.1\n```\n\n## 使用示例\n\n### 基本用法\n\n处理当前目录下所有 PDF 文件：\n\n```bash\ndocker run --rm \\\n -v ./:/input \\\n -v ./output:/output \\\n xeden3/pdfbookmarkmaker:v1.0\n```\n\n### 添加标题页\n\n使用 `-e TITLE` 环境变量添加标题页：\n\n```bash\ndocker run --rm \\\n -e TITLE=\"文档标题
副标题\" \\\n -v ./:/input \\\n -v ./output:/output \\\n xeden3/pdfbookmarkmaker:v1.1\n```\n\n标题页支持以下 HTML 标签：\n\n- `` - 粗体\n- `` - 斜体\n- `` - 字体大小\n- `` - 字体颜色\n- `
` - 换行\n\n### 单文件模式\n\n使用环境变量指定单个 MD 和 PDF 文件进行转换：\n\n```bash\ndocker run --rm \\\n -e INPUT_MD_FILE=\"/input/document.md\" \\\n -e INPUT_PDF_FILE=\"/input/document.pdf\" \\\n -e OUTPUT_PDF_FILE=\"/output/result.pdf\" \\\n -e TITLE=\"文档标题ABC
副标题\" \\\n -v ./:/input \\\n -v ./output:/output \\\n xeden3/pdfbookmarkmaker:v1.0\n```\n\n参数说明：\n\n- `INPUT_MD_FILE` - MD 文件路径（必需）\n- `INPUT_PDF_FILE` - PDF 文件路径（必需）\n- `OUTPUT_PDF_FILE` - 输出 PDF 路径（可选，默认在输出目录生成 `{原文件名}_bookmarked.pdf`）\n- `TITLE` - 标题页文本（可选）\n\n## Markdown 文件格式\n\n工具会自动识别以下格式的标题：\n\n```markdown\n# 一级标题\n## 二级标题\n### 三级标题\n#### 四级标题\n```\n\n### 示例\n\n假设 `document.md` 内容如下：\n\n```markdown\n# 第一章概述\n\n这是第一章的内容...\n\n## 1.1 背景介绍\n\n本节介绍背景...\n\n### 1.1.1 研究现状\n\n本节讨论研究现状...\n```\n\n生成的书签将保持原有层级结构。\n\n## 环境变量\n\n| 变量名 | 说明 | 示例 |\n| ------------ | -------------- | ------------- |\n| `INPUT_DIR` | 输入目录路径 | `/input`（默认） |\n| `OUTPUT_DIR` | 输出目录路径 | `/output`（默认） |\n| `TITLE` | 标题页文本（支持 HTML） | `标题` |\n\n## 算法说明\n\n### 标题匹配策略\n\n工具使用 4 级匹配策略查找 PDF 中的标题位置：\n\n1. **精确匹配** - 在正文页查找完整标题文本\n2. **全文回退** - 在整个文档中查找完整标题文本\n3. **关键词匹配（前10字符）** - 如果完整匹配失败，使用前10个字符作为关键词\n4. **关键词匹配（前6字符）** - 如果仍未匹配，使用前6个字符作为关键词\n\n### 文本规范化\n\n工具自动处理以下文本差异：\n\n- 中英文/数字之间的多余空格\n- 中文 Unicode 变体字（如「⼩」转换为「小」）\n- Markdown 标记（`**`、`*`、Emoji 等）\n\n## 输出示例\n\n运行成功后会显示处理进度：\n\n```\n========================================\n PdfBookmarkMaker Docker\n========================================\n\n处理: document\n PDF: /input/document.pdf\n MD: /input/document.md\n OUT: /output/document_bookmarked.pdf\n[1/5] 解析 MD 标题: document.md\n 找到 15 个标题\n[2/5] 在 PDF 中定位页码: document.pdf\n 成功匹配 14/15 个标题\n[3/5] 构建输出 PDF\n[4/5] 添加书签（层级结构）\n L1 P1: 第一章概述\n L2 P3: 1.1 背景介绍\n L3 P5: 1.1.1 研究现状\n ...\n[5/5] 输出: /output/document_bookmarked.pdf\n 完成\n\n========================================\n完成: 处理 1 个文件\n输出目录: /output\n========================================\n```\n\n## 依赖项\n\n### Docker 镜像\n\n- Python 3.11-slim\n- fonts-wqy-zenhei（文泉驿正黑字体）\n- fonts-wqy-microhei（文泉驿微米黑字体）\n- pypdf\n- reportlab\n\n### 直接运行\n\n- Python 3.8+\n- pypdf\n- reportlab\n\n## 已知问题\n\n- 部分 PDF 使用特殊字体可能导致匹配失败\n- 假设 PDF 前2页为目录页，会跳过该区域进行匹配\n\n## 许可证\n\nMIT License\n\n","has_starred","hub_user","immutable_tags_settings",{"_71":11,"_72":73},"enabled","rules",[74],".*","is_automated","permissions",{"_78":17,"_79":11,"_80":11},"read","write","admin","user","storage_size",77438205,"orgData","recentTags",[87],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":98,"_46":120,"_121":90,"_122":29,"_123":52,"_53":124,"_125":126,"_127":105,"_128":120,"_129":62,"_130":17},"content_type","creator",26709373,"digest","sha256:e24ec19ddc48c95dd8d9cfb78b650abad710517958eed0690d0ecebc1b7ce4ca","full_size",77354607,"id",1144178945,"images",[99,114],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},"architecture","amd64","sha256:58a322d6b3383fbc03a5e297c25d319a20ac4fccbff2608019b3c4da5f3528f2","features","last_pulled","2026-09-23T13:03:39.974404698Z","last_pushed","2026-05-06T16:00:16.145853176Z","os","linux","os_features","os_version","size","variant",{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":115,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},"unknown","sha256:dd2a801d875afc4bcca41be45fcbd694d27550e9ce071ac7de5a7dd3fce4c79d","2026-09-21T15:36:29.80927266Z","2026-05-06T16:00:14.174850038Z",1013,"2026-05-06T16:00:18.43711Z","last_updater","last_updater_username","media_type","v1.0","repository",30926940,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":142,"_149":150,"_138":160,"_161":11},{"_36":143,"_38":144,"_41":42,"_43":44,"_45":11,"_46":47,"_48":49,"_50":145,"_53":31,"_28":29,"_54":55,"_56":-5,"_57":58,"_59":60,"_61":62,"_63":-5,"_64":58,"_65":66,"_67":11,"_68":29,"_69":146,"_75":11,"_76":148,"_81":29,"_82":83},[],[40],[52],{"_71":11,"_72":147},[74],{"_78":17,"_79":11,"_80":11},"tags",{"_151":60,"_152":-5,"_153":-5,"_154":155},"count","next","previous","results",[156],{"_88":40,"_89":90,"_91":92,"_93":94,"_95":96,"_97":157,"_46":120,"_121":90,"_122":29,"_123":52,"_53":124,"_125":126,"_127":105,"_128":120,"_129":62,"_130":17},[158,159],{"_100":101,"_91":102,"_103":44,"_104":105,"_106":107,"_108":109,"_110":44,"_111":-5,"_112":94,"_59":62,"_113":-5},{"_100":115,"_91":116,"_103":44,"_104":117,"_106":118,"_108":115,"_110":44,"_111":-5,"_112":119,"_59":62,"_113":-5},[],"canDeleteTags","actionData","errors"]

xeden3/pdfbookmarkmaker

Tags for xeden3/pdfbookmarkmaker