markdown-to-docxlisted
Install: claude install-skill black-yt/skills
# Markdown to DOCX
## 文件导航
| 序号 | 文件内容概览 | 关键词 | 触发时机 | 文件路径 |
| --- | --- | --- | --- | --- |
| 1 | 说明 Markdown 转 DOCX 的使用边界和执行入口,覆盖依赖、`build_docx.py`/`count_visible_words.py` 参数、本地图片、caption、表格展开、公式降级、字体、输出检查和 `/tmp` 清理。 | Markdown to DOCX、Word、`.docx`、`python-docx`、`build_docx.py`、`count_visible_words.py`、images、caption、HTML img、tables、formula、font、word count、quality check | 触发本 skill 后默认读取;需要把 Markdown 交付为 Word 前;选择脚本参数前;处理图片/表格/公式前;检查 docx 字数、图片、caption 或格式问题前读取 | `SKILL.md` |
| 2 | 展开从零组织一份 Word 文档的内容工作流,说明 Markdown 材料如何拆成一级章节、图文块、居中图片、caption、目录结构、正文段落和可维护的分文件草稿。 | document workflow、section plan、Heading 1、image-text block、caption、table-to-text、directory structure、split draft、article、report、public draft、PR document | 从零规划 DOCX 文档结构前;把杂乱 Markdown/图片整理成正式 Word 前;需要拆分长文、组织图文块、重写一级章节或统一 caption 时必须读取 | [references/docx-workflow-and-structure.md](references/docx-workflow-and-structure.md) |
## 使用边界
- 核心技能是把 Markdown 文档转换成可交付的 Word `.docx`,不绑定某一种业务场景。
- 适合文章、报告、公告、release note、项目文档、说明书、会议材料、图文解读稿、官网/公众号草稿和对外沟通材料。
- 优先使用本 skill 的 `scripts/build_docx.py`,不要临时手写一次性转换脚本。
- 图片应是本地相对路径,推荐放在 Markdown 同级的 `images/` 目录。
- 不要依赖远程图片 URL;先下载到项目内再引用。
- 不要把生成文件长期放进 `/tmp`;临时测试可以放 `/tmp`,测试后必须清理。
- 如果用户要求严格保留复杂 Markdown 表格为 Word 网格表,本脚本不是最佳选择;它更适合把 Markdown 排成可读的 Word 文档和图文块。
- 如果用户要求企业模板、页眉页脚、封面、目录、编号样式、参考文献格式,应在脚本基础上扩展或使用 Word 模板驱动流程。
## 能力范围
输入能力:
- Markdown 标题、段落、粗体、斜体、inline code、链接。
- 无序列表、有序列表、嵌套列表。
- blockquote。
- fenced code block,按普通文本块进入 Word,不做语法高亮。
- Markdown 图片和 HTML `<