核心功能
docx-to-md 是一款专注于文档格式转换的轻量级工具，主要解决 Word 文档向 Markdown 迁移的痛点。该技能基于 python-docx 库实现，能够将 .docx 文件转换为标准 Markdown 格式，并自动提取文档内嵌的图片资源到指定目录。
显著优点
1. 格式保留完整：支持标题层级（1-4级）、无序/有序列表、表格等常见 Word 元素的精准映射
2. 图片自动提取：内嵌图片自动导出为 PNG/JPG/GIF，并按规范命名（image_*.扩展名）
3. 使用灵活：同时支持 Python 脚本调用和命令行运行，便于集成到自动化工作流
4. 零配置上手：默认行为智能（自动生成 _output 目录），降低使用门槛
潜在局限
- 依赖单一：核心依赖
python-docx库，若该库更新中断或出现兼容性问题，技能可能失效 - 复杂格式支持有限：未明确提及对页眉页脚、脚注尾注、复杂样式、修订标记、OLE 对象等高级 Word 特性的处理能力
- 图片格式判定：基于扩展名识别图片格式，对特殊编码或罕见格式的兼容性存疑
- 无预览机制：转换前无法预览效果，复杂文档可能需要多次调试
适合人群
- 技术写作者：需要将 Word 稿迁移至 Git/Markdown 文档体系
- 开发者：构建文档自动化处理流水线
- 内容运营：批量处理历史 Word 素材，统一至 Markdown 知识库
常规风险
- 路径注入风险：若输入文件名或输出目录参数未经校验，可能存在路径遍历隐患（建议使用者自行校验路径合法性）
- 图片隐私泄露：自动提取功能会原样输出文档内所有图片，敏感截图可能被意外暴露
- 编码兼容：Word 文档的编码复杂性可能导致特殊字符转换异常