SuperAPI AI 工具集

docx-to-markdown

办公与效率

查看项目

更新于 10-15 21:35

技能介绍

用途:把 Microsoft Word(.docx)文件转换为 GitHub-Flavored Markdown,保留表格、图片、列表、链接、标题层级与代码块等结构。

主要能力:GFM 表格转换;提取内嵌图片(可内联 base64 或输出到指定目录);保留有序/无序列表、超链接与标题层级;等宽文本转为代码块;跨 Windows、macOS、Linux 使用。转换管线为 DOCX → mammoth → HTML → turndown → Markdown,采用两阶段转换以获得较好效果。

使用方式:需先安装依赖。可选 ck init(ClaudeKit CLI,运行 install.sh 处理所有技能),或手动进入 .claude/skills/docx-to-markdown 执行 npm install,依赖为 mammoth、turndown、turndown-plugin-gfm。转换命令示例:node .claude/skills/docx-to-markdown/scripts/convert.cjs --input ./document.docx;可用 -o 指定输出路径,用 --images ./images/ 将图片保存到目录。CLI 选项包括 --input/-i(必填)、--output/-o(默认 {input}.md)、--images、--help/-h。成功时返回 JSON,含 success、input、output 及 images、tables、headings 统计。

适用场景:需要把 Word 文档迁移到 Markdown 文档库、仓库文档或静态站点时使用。

限制:复杂版式(分栏、文本框)可能无法保留结构;合并单元格只能生成基础 Markdown 表格;批注与修订会被剥离;部分格式(字体、颜色)在转换中丢失。系统需已安装 pandoc。