90.批量md(markdown)文件转为pdf

1. 软件是做什么的？

这是一款桌面软件，用来把 Markdown（.md）文档批量转换成 PDF。你可以把它理解为：

• 把写好的 md 文档，一次性生成可打印、可分享的 pdf 文件。

• 不需要写代码，不需要命令行，点按钮就能用。

✅ 适合哪些场景？

• 课程资料、学习笔记导出 PDF

• 公司文档归档、发客户材料

• 批量整理文档用于打印

---

2. 软件核心能力一览

• 🚀 批量转换：一次处理多个 md 文件

• 🧩 拖拽选择目录：可直接拖文件夹到输入框

• 📁 支持子文件夹扫描：可递归读取目录

• ⏯ 支持暂停 / 继续：转换中随时可暂停，后续继续

• 🧾 错误日志记录：失败信息会写入 error.log

• 🛡 关闭软件自动释放资源：关闭时会强制清理任务和临时资源

---

3. 界面说明（操作页）

进入软件后，最常用的是 “操作”页。

3.1 源文件夹

• 放你 .md 文件的目录。

• 可以点击“选择”按钮，也可以直接拖拽文件夹到输入框。

3.2 输出文件夹

• PDF 生成到这里。

• 建议先新建一个空目录，方便查看结果。

3.3 按钮区

• 加载文件：读取源文件夹中的 md 文件

• 开始：开始批量转换

• 暂停 / 继续：中断或恢复转换任务

• 包含子文件夹（开关）：

  • 开：读取当前目录 + 所有子目录

  • 关：只读取当前目录

3.4 文件列表

你会看到每个文件的状态：

• 等待中

• 处理中

• 已完成

• 失败

并且可以看到总体成功数、失败数。

---

4. 快速上手（3 分钟）

第一步：准备文件

把 md 文件放到一个文件夹里，例如：

D:\docs\md
├─ A.md
├─ B.md
└─ media
   ├─ image1.png
   └─ image2.jpg

第二步：选择路径

1. 源文件夹选择 D:\docs\md

2. 输出文件夹选择 D:\docs\pdf

3. 点击“加载文件”，确认列表里有文件

第三步：开始转换

点击“开始”，等待状态变成“已完成”。

完成后在输出目录看到：

D:\docs\pdf
├─ A.pdf
└─ B.pdf

---

5. 推荐的文档与图片写法（重点）

图片显示是否正常，和 md 里的图片路径关系很大。

✅ 推荐写法 1：相对路径（最稳）

![流程图](media/image1.png)

✅ 推荐写法 2：同目录下图片

![封面](cover.png)

⚠ 不推荐：跨电脑绝对路径

![图](F:/旧电脑目录/media/image1.png)

如果是旧电脑导出的绝对路径，在新电脑可能找不到文件。 软件已做兼容，但仍建议你尽量改成 相对路径。

---

6. 暂停 / 继续怎么用？

暂停

• 转换进行中，点击“暂停”

• 按钮会短暂显示“暂停中...”

• 当前任务停止后，未完成文件会回到“等待中”

继续

• 点击“继续”

• 软件会从未完成文件继续处理（已完成的不会重复）

---

7. 错误日志怎么查看？

当转换失败时，会把错误写入 error.log。

开发环境（你当前本地运行）

通常在项目根目录，例如：

90.批量md(markdown)文件转为pdf\error.log

打包后的软件

通常在 exe 同目录。

日志内容示例

[2026-03-02T04:11:23.000Z] [mdpdf:fileRead] 业务.md: ENOENT: no such file or directory
[2026-03-02T04:11:30.000Z] [mdpdf:pdfWrite] 概论.md: 生成PDF失败

看到失败时建议：

1. 先看是哪个文件失败

2. 对照错误类型（读取失败、渲染失败、生成PDF失败）

3. 优先检查图片路径和文件权限

---

8. 常见问题（FAQ）

Q1：为什么“开始”按钮点不了？

请确认：

• 已选择源文件夹

• 已选择输出文件夹

• 已点击“加载文件”并成功列出文件

Q2：为什么图片没显示？

优先检查：

• 图片文件是否真实存在

• 路径是否写错（大小写、斜杠、文件名）

• 是否使用了旧电脑绝对路径

Q3：关闭软件会不会卡住？

不会。软件已优化：关闭时会强制停止任务并释放资源（窗口、控制器、临时文件夹）。

Q4：失败后要全部重来吗？

不需要。可以直接点“继续”，只处理未完成文件。

---

9. 给新手的最佳实践 ✅

• 先拿 1~2 个文件试跑，确认格式正常再批量。

• 图片统一放 media 文件夹，路径统一用相对路径。

• 输出目录建议独立，避免和源目录混在一起。

• 出错先看界面状态，再看 error.log。

---

10. 一个完整示例（从 0 到 1）

示例目录

D:\project
├─ md
│  ├─ 项目说明.md
│  ├─ 需求文档.md
│  └─ media
│     ├─ arch.png
│     └─ flow.png
└─ pdf

项目说明.md 示例片段

# 项目说明

这是系统架构图：

![系统架构](media/arch.png)

这是流程图：

![流程图](media/flow.png)

操作流程

1. 源文件夹选 D:\project\md

2. 输出文件夹选 D:\project\pdf

3. 点击“加载文件”

4. 点击“开始”

5. 在 D:\project\pdf 查看结果

---

11. 联系与反馈

如果你遇到问题，建议反馈时附上：

• 失败文件名

• 错误提示截图

• error.log 对应片段

这样可以更快定位和修复问题 🙌