文件转 PDF

在日常开发或文档处理中，经常需要将 Word、Excel、Markdown 笔记或截图统一归档为 PDF。手动操作不仅繁琐，且难以实现自动化与批量化，混杂的文件类型往往需要依赖多个外部工具。

核心能力与转换逻辑

该技能通过命令行参数接收输入，自动识别扩展名并分发至相应的转换引擎，核心流程如下：

• Office 文档与 HTML：交由 LibreOffice 的 headless 模式处理，无需启动图形界面。
• 图片文件：直接调用 Pillow 转换为 PDF，并妥善处理 RGBA 透明背景。
• Markdown 与纯文本：先用 Python 库解析并注入中文字体及代码高亮样式生成 HTML，再交由 LibreOffice 转码。

此外，支持 --merge 合并多张图片、--recursive 递归遍历目录，以及 --soffice 指定自定义可执行文件路径。

适用边界与注意事项

在实际应用中，有几个工程细节需要注意：

• 图片转换是独立模块，不依赖 LibreOffice。
• Markdown 和纯文本的排版高度依赖中间生成的 HTML 样式。
• 合并图片时严格按文件名排序，默认不覆盖已有 PDF，需显式添加 --overwrite 参数。
• 确保运行环境中正确安装了 LibreOffice，并注意不同操作系统下的路径自动检测差异。