批量转换 Markdown 为独立 PDF 并打包单个 ZIP 归档导出

将全部技术文档装订为一本单体书册非常适合通读，但许多企业业务场景更需要按模块分发独立的 PDF 说明书、技术规范或员工手册。如果逐篇手动下载数十个 PDF，不仅极其繁琐，还会频繁触发浏览器的多文件弹窗拦截。通过 md2pdf，您可以一键将多篇 Markdown 批量转为独立 PDF，并整齐打包在单个 ZIP 压缩文件中瞬间完成交付。

本文将介绍 md2pdf 的批量独立渲染机制、基于 JSZip 的纯前端打包原理以及如何按需规划目录归档。

何时选择独立 PDF 包而非单本合订书

两种输出模式完美对应不同的文档交付诉求：

• 模块化精准分发：只需将特定子模块的操作手册提供给外部合作伙伴，无需暴露全套技术文档。
• 微文档归档检索：独立的 API 接口文档或版本变更日志更便于按照分类单独存档检索。
• 杜绝多文件下载弹窗拦截：打包为一个 ZIP 归档，彻底避开主流浏览器针对连续自动下载的安全限制与警告。

Export Modes in md2pdf:
Mode A (Consolidated Book):
- Multi-chapter single PDF (e.g., project-documentation.pdf)
- Unified Table of Contents & continuous page numbering

Mode B (ZIP Archive Bundle):
- project-docs-bundle.zip
  ├── 01-getting-started.pdf
  ├── 02-architecture.pdf
  └── 03-api-reference.pdf

基于 JSZip 的浏览器本地压缩处理

md2pdf 采用成熟的 JSZip 库，完全在用户浏览器本地组装压缩包，无需中转远程服务器：

1. 分步流式渲染：队列中的每个 Markdown 文件通过 pdf-lib 引擎独立编译为高质量 PDF 二进制流。
2. 规范文件命名：生成的 PDF 自动继承源文件名或根据文档主标题命名，一目了然。
3. 内存即时封包：每篇 PDF 渲染完毕后，其二进制数据即刻推入内存中的 ZIP 归档流中。
4. 单次原生下载：当全部文档编译就绪后，系统自动触发单次浏览器下载动作，输出最终 ZIP 包。

完整保留 ZIP 内的项目目录树层级

在导出多层深度的仓库文档时，md2pdf 提供了灵活的目录保持机制：

• 保持原始层级：原本位于 docs/api/endpoints.md 的文档在 ZIP 中将对应存储为 docs/api/endpoints.pdf。
• 扁平单层归档：也可选择消除子目录，将所有 PDF 规整保存在同一根目录下，并自动避免同名冲突。

前端性能调优与垃圾回收内存管理

连续生成数十个高清 PDF 文件需要严谨的前端资源调度。

md2pdf 采用分块流式作业机制，在完成单篇文档渲染后立刻主动销毁中间 DOM 节点与图片缓存，促使浏览器及时执行垃圾回收（GC）。这种设计彻底消除了内存泄漏风险，即便处理庞大的长文合集也能确保浏览器稳定流畅。

在 md2pdf 中导出 ZIP 压缩包

若要输出 ZIP 打包文档，只需在文件选择区勾选目标 Markdown，将输出模式切换为“独立 PDF (ZIP)”，随后点击导出。短短数秒内，所有专属技术指南便会妥善封装为一个精炼的 ZIP 文件供您保存分发。