Agent Skills
返回列表
文档批量转 Markdown

文档批量转 Markdown

办公效率 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f474679a/tomark-skill。

技能介绍

文档转换的痛点

在 Windows 环境中，.docx、.doc 和 .wps 文档无法直接可靠地转成干净的 Markdown：.docx 依赖 mammoth 保留标题、加粗和列表，.doc 与 .wps 需要 WPS Office 先转换成 .docx，而批量处理时还要保持子目录结构、区分成功与失败文件。

工作流程与能力

tomark-skill 围绕 scripts/convert_to_markdown.py 完成转换：

  • 单文件或批量转换：配置 SRC_DIR，可选 OUT_DIR，默认输出到 /markdown_output/
  • 格式路由：.docx 通过 mammoth 转换；.doc / .wps 通过 KWps.Application COM 先转 .docx
  • 结果可审计：输出 Markdown 并生成 转换报告.md，列出成功与失败
  • 编码稳定：运行时建议启用 UTF-8 模式，脚本内部强制 stdout 为 UTF-8，输出文件为 UTF-8

适用边界

该技能主要面向 Windows 办公文档处理。若未安装 WPS Office，.doc 与 .wps 无法转换，只能处理 .docx；加密文档或严重损坏文件可能失败。它解决的是格式转换与批量输出问题，不承诺对复杂表格、公式或版式做完美还原。

使用场景

  • 维护 Windows 文档库时，把分散子目录中的 .docx 批量导出为 Markdown。
  • 处理旧版 .doc 或 .wps 时，借助 WPS 先转 .docx 再导出 Markdown。
  • 转换后查看 转换报告.md，定位密码保护或损坏导致的失败文件。
  • 整理带子目录的办公材料，让输出 .md 保留原文件夹层级。

适合人员

  • 维护 Windows 办公文档归档的工程师，需要稳定输出 UTF-8 Markdown。
  • 整理旧版 Word/WPS 资料的编辑，需要批量转换并保留标题、加粗和列表。
  • 处理嵌套文件夹文档的团队助理，需要让 .md 输出沿用原目录结构。
  • 排查批量转换失败的运维同学，需要根据转换报告定位异常文件。