M3-markconv库找不到wkhtmltopdf问题
📝 摘要
在使用 markconv 进行 PDF 转换时，你可能会遇到 OSError: No wkhtmltopdf executable found 错误。这表示系统没有安装 wkhtmltopdf 工具，只需要安装它就能解决 💪
1. 问题描述 📚
1.1 主要报错
当你运行 PDF 转换代码时，会看到以下关键报错：
OSError: No wkhtmltopdf executable found: "C:\\Program Files\\wkhtmltopdf\\bin\\wkhtmltopdf.exe"
这个错误的意思是：找不到 wkhtmltopdf 可执行文件 🔍
markconv 会在默认路径 C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe 查找它。
1.2 错误原因
markconv 的 PDF 转换功能底层依赖 wkhtmltopdf 工具。如果系统没有安装 wkhtmltopdf，就会报这个错误。
1.3 解决方案
解决办法很简单：下载并安装 wkhtmltopdf 就可以！下面我们来看具体步骤 📥
2. 安装 wkhtmltopdf 📦
2.1 下载安装包
-
访问 wkhtmltopdf 官方下载页面：wkhtmltopdf.org/downloads.h…
-
根据你的操作系统选择对应的安装包
-
对于 Windows 用户，推荐下载 64 位版本：github.com/wkhtmltopdf…
2.2 运行安装
-
双击下载的
.exe文件 -
按照提示完成安装
-
安装到默认路径：
C:\Program Files\wkhtmltopdf\
2.3 验证安装
重要：不需要配置环境变量！ 只要安装到默认路径，Python 代码会自动找到 ✅
你可以直接在命令行运行验证：
"C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe" --version
如果输出版本号，说明安装成功 ✅
3. 总结 📌
遇到 No wkhtmltopdf executable found 错误不用慌，解决方案很简单：
-
下载 wkhtmltopdf 安装包
-
安装到默认路径
-
重启电脑
-
重新运行代码
搞定！🎉
最后更新时间：2026-04-10
