核心用法
Doc Converter 是一款基于 Python 的本地文档格式转换工具，支持 Word(.docx)、PDF、Markdown(.md)、HTML 四种格式之间的高保真互转。用户通过提供源文件路径和目标格式即可触发转换流程，支持自动检测文件扩展名匹配最佳转换方案。
主要转换场景：
- Word → PDF：基于 python-docx + fpdf2 实现，保留标题层级、表格结构和基础格式
- Markdown → PDF：解析 Markdown 语法，转换为带层级标题和列表格式的 PDF
- Markdown → Word：完整支持标题、列表、粗体/斜体、代码块等 Markdown 元素映射到 Word 样式
- HTML → PDF：调用 wkhtmltopdf 引擎，支持 A4 页面尺寸和边距自定义
显著优点
1. 完全本地化：所有转换在本地执行，无需上传文件至云端服务器，杜绝数据泄露风险
2. 开源透明：基于 MIT-0 协议，依赖 python-docx、fpdf2、markdown 等成熟开源库
3. 零 API 成本：不依赖任何付费 API 或外部服务，无调用次数限制
4. 跨平台支持：兼容 Windows、macOS、Linux 三大操作系统
5. 高保真输出：特别针对标题层级、表格、代码块等结构元素做了样式映射优化
潜在缺点与局限性
1. 复杂格式丢失：Word 中的复杂排版（分栏、文本框、图文混排）可能无法完整保留
2. 字体依赖：中文等多语言场景需要系统安装对应 Unicode 字体，否则可能出现乱码
3. 外部依赖要求：HTML 转 PDF 必须预装 wkhtmltopdf 系统组件，增加部署复杂度
4. 图片处理有限：当前实现主要聚焦文本结构，图片提取和嵌入的支持较为基础
5. 无实时预览：转换前无法预览效果，需执行后检查结果
适合人群
- 开发者/技术写作者：需要将 Markdown 文档输出为正式 PDF/Word 交付物
- 隐私敏感用户：处理含敏感信息的文档，拒绝云端转换服务
- 自动化工作流构建者：希望通过脚本批量处理文档转换任务
- 跨平台办公用户：需要在不同操作系统间保持一致的文档处理能力
常规风险
- 输入文件路径需确保存在且可读，否则触发异常
- 输出路径需有写入权限，建议提前确认磁盘空间
- wkhtmltopdf 依赖可能因系统环境差异导致安装失败，需参考官方文档排查
- 大文件转换可能消耗较高内存，建议分批处理超大型文档