前言¶

技术文档、需求说明、合作方交付物里，.docx 仍然很常见。要进 Git、进知识库或交给 Coding Agent 继续改，往往需要 Markdown。手工复制会丢标题层级、列表和行内格式；图片要么变成外链，要么得一张张另存再补链接。下面介绍 SkillHub 上的 docx-to-md-with-images，它面向 Agent 场景，把文档格式转换写进 Skill 工作流，重点处理 .docx 的图片抽取与结构保留。

这是什么¶

docx-to-md-with-images（坐标 @user_29e2fa9e/docx-to-md-with-images）是 SkillHub 社区来源（community）的办公效率类 Skill，分类为 office-efficiency，当前版本 1.0.0，由发布者 user_29e2fa9e 维护。标签 requires_api_key=false，表示按 SkillHub 页面说明，安装与使用不依赖额外 API Key。

官方简介：将 Word（.docx）及其他文档格式转换为 Markdown；主路径针对 .docx，强调完整图片提取、行内格式与文档结构保留；对 PDF、PPTX、XLSX、HTML、CSV、JSON、XML 等格式，通过 markitdown 作为回退能力支持。

SkillHub 展示页：https://www.skillhub.cn/skills/user_29e2fa9e/docx-to-md-with-images
API 条目：https://api.skillhub.cn/user_29e2fa9e/docx-to-md-with-images

核心功能¶

依据官方简介，可核实的能力如下。

1. .docx → Markdown（主路径）
   完整抽取文档内图片；保留行内格式（如加粗、斜体等语义）；尽量保持原有标题、段落、列表等结构，便于后续在 Markdown 工具链中编辑。

2. 多格式回退
   除 Word 外，还支持 PDF、PPTX、XLSX、HTML、CSV、JSON、XML 等，通过 markitdown 回退完成转换（能力与主路径的「图片 + 结构」侧重可能不同，以实际转换结果为准）。

3. 无需 API Key
   SkillHub 标签标明 requires_api_key=false，适合本地或内网 Agent 环境，不额外绑定第三方密钥（仍取决于 Agent 与 Skill 包内是否声明其他依赖，安装后应以 SKILL.md 为准）。

安装与启用¶

Skill 遵循通用 SKILL.md 格式。SkillHub 页面给出的安装方式是：让 AI 按官方安装文档安装该坐标。

方式一：提示词安装（官方页面原文）¶

将下面提示发给当前使用的 AI Agent：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_29e2fa9e/docx-to-md-with-images`。

Agent 会按 SkillHub 安装与优先源配置 检查 CLI、选择正确的 skills 目录并执行安装。

方式二：SkillHub CLI¶

先确认是否已安装 skillhub：

command -v skillhub && skillhub --version

未安装时，可按官方文档执行完整安装（CLI + 默认 Skill）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

仅安装 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录（装到默认 ./skills/ 可能不会被识别）。官方文档列出的常用路径示例：

以 Cursor 为例，安装命令形如：

skillhub install @user_29e2fa9e/docx-to-md-with-images --dir ~/.cursor/skills/

安装完成后，按所用 Agent 的要求刷新或重启，使新 Skill 被加载。

典型用法¶

公开页面未附带独立 CLI 子命令说明，典型用法是：安装并启用 Skill 后，在对话中提供待转换文件路径或附件，说明需要转为 Markdown 并保留图片。

可复现的安装入口（与 SkillHub 展示页一致）：

请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_29e2fa9e/docx-to-md-with-images`。

安装完成后，可按任务描述让 Agent 执行转换，例如：

1. 指明输入为本地 .docx 文件路径（或上传文件）。
2. 要求输出 Markdown，并说明图片应抽取到相对目录、在 .md 中用相对路径引用。
3. 若输入为 PDF、PPTX 等，说明格式；Agent 将按 Skill 说明走 markitdown 回退路径。

具体脚本名、依赖包与输出目录布局以安装包内 SKILL.md 为准；本文不臆造未在官方资料中出现的命令行参数。

适用场景与注意¶

适合谁

• 需要把 Word 交付物批量或按需转成 Markdown，且关心图片与文档结构的开发者、技术写作者。
• 已在 Cursor、Claude Code、Codex 等环境使用 Skills，希望转换逻辑固化在 Agent 侧、减少重复提示词的同学。

使用注意

• 主路径与回退路径：.docx 是能力描述中的重点；其他格式依赖 markitdown，版式复杂的幻灯片或扫描版 PDF 可能出现结构简化或丢失，转换后应人工抽检。
• 安装目录：务必使用 skillhub install ... --dir <当前 Agent 的 skills 目录>，避免 Skill 未被加载。
• 平台数据：SkillHub 页面统计会变动；撰写时抓取的条目为评分 100000、下载 1451、安装 74，以 展示页 实时数据为准。

结尾¶

docx-to-md-with-images 把「Word → Markdown + 图片落地 + 结构保留」收进一个可安装的 Agent Skill，并扩展多种办公文档格式的 markitdown 回退。若你经常在 Agent 里处理 .docx 归档或迁移，可先按官方坐标安装，再对照包内 SKILL.md 核对依赖与输出约定。

• SkillHub 展示页：https://www.skillhub.cn/skills/user_29e2fa9e/docx-to-md-with-images
• API 条目：https://api.skillhub.cn/user_29e2fa9e/docx-to-md-with-images
• 安装说明：https://skillhub.cn/install/skillhub.md