前言¶

写技术文档时，团队里常见两套稿：开发用 Markdown 维护，对外或走审批用 Word。手工互拷格式、表格和代码块，既慢又容易丢样式。合并单元格、Mermaid 图、中文段落排版，在两种格式之间尤其难对齐。

下面介绍 SkillHub 上的社区 Skill markdown转word（坐标 @user_27f88699/md2docx），把「Markdown ↔ Word」的转换交给当前 Agent 执行，并针对表格合并、图表与中文排版做了能力说明。

这是什么¶

markdown转word 是 SkillHub 分类 office-efficiency 下的社区 Skill，发布者为 user_27f88699，当前页面标注版本 v2.0.0，来源为 community。官方简介概括为：Markdown 与 Word 双向转换，并支持合并单元格（rowspan/colspan）、Mermaid 图表渲染、代码高亮、中文排版优化。

页面标签标明 requires_api_key=false，即安装后使用不依赖额外 API Key。SkillHub 展示页上的统计（以页面抓取为准）为评分 100000、下载 8004、安装 38。

• Skill 展示页：https://www.skillhub.cn/skills/user_27f88699/md2docx
• 官方坐标链接：https://api.skillhub.cn/user_27f88699/md2docx

核心功能¶

以下能力均来自 SkillHub 官方简介，未在资料中出现的细节不展开：

1. 双向转换：Markdown 转 Word，以及 Word 转 Markdown（具体执行方式由 Skill 包内 SKILL.md 指导 Agent，安装后向 Agent 说明源文件与目标格式即可）。
2. 表格合并单元格：支持 rowspan、colspan，适合复杂表头的需求文档或测试矩阵。
3. Mermaid 图表：可将文档中的 Mermaid 源码渲染进 Word 输出（与纯文本粘贴相比，减少手工制图）。
4. 代码高亮：保留或生成带高亮样式的代码块，便于技术说明类文档。
5. 中文排版优化：针对中文文档的常见排版问题做处理，减轻 Word 与 Markdown 互转后的版式错乱。

安装与启用¶

SkillHub 推荐通过 skillhub CLI 安装，并必须把技能装到当前 Agent 能识别的 skills 目录，否则默认落在 ./skills/ 且可能不被加载。

1、安装 skillhub CLI（若尚未安装）¶

先检查是否已安装：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行完整安装（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

完整说明见：https://skillhub.cn/install/skillhub.md

2、安装本 Skill¶

SkillHub 页面给出的安装提示为：根据上述安装文档，安装 @user_27f88699/md2docx。对应 CLI 形式为将技能装到当前环境的 skills 目录（--dir 必填）：

skillhub install user_27f88699/md2docx --dir <skills 目录>

常用 Agent 的 skills 路径（摘自 SkillHub 安装文档）：

安装后按你所用客户端要求重启或重载 Agent，使新 Skill 生效。

也可将下面提示词发给 AI，由其按官方文档完成安装（与 SkillHub 页面文案一致）：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_27f88699/md2docx。

典型用法¶

公开页面未附带独立的命令行示例脚本；标准路径是：安装 Skill → 在对话中说明转换方向与文件路径 → 由 Agent 按 Skill 指令完成转换。

可操作的起步方式：

1. 确认 markdown转word 已出现在当前 Agent 的 skills 目录中。
2. 在对话中明确需求，例如：将某份 .md 转为 .docx，或把 .docx 抽成 Markdown；若文档含合并单元格表格、Mermaid 代码块或中文长文，在提示里一并说明，以便对齐 Skill 简介中的能力范围。
3. 检查输出文件的表格、图表与代码块是否符合预期；复杂版式仍可能需要人工微调。

搜索技能时，也可使用：

skillhub search md2docx

适用场景与注意¶

适合谁

• 经常用 Cursor、Claude Code 等带 Skills 的 Agent 写文档，需要在 Markdown 与 Word 之间来回交付的人。
• 文档里表格较多、需要 rowspan/colspan，或内含 Mermaid、代码块的技术说明、方案稿。

注意

• 本 Skill 为 community 来源，行为以安装包内说明为准；升级前留意 SkillHub 上的版本号（当前为 2.0.0）。
• 安装务必使用 skillhub install ... --dir <skills 目录>，路径错误会导致 Agent 无法加载。
• 双向转换与复杂版式无法保证与手工排版完全一致，正式对外文档建议保留一次人工校对。
• 资料中未提供独立服务 SLA；转换在本地 Agent 会话中完成，大文件或极复杂版式需自行验证耗时与结果。

结尾¶

markdown转word 把 Markdown 与 Word 的双向转换、表格合并、Mermaid、代码高亮和中文排版优化收敛到一个 SkillHub 技能里，适合挂在日常写文档的 Agent 上使用。安装与目录配置以 SkillHub 官方文档为准。

• Skill 页：https://www.skillhub.cn/skills/user_27f88699/md2docx
• 安装说明：https://skillhub.cn/install/skillhub.md