---
name: docx-to-md
description: 将 Word .docx 文档转换为 Markdown，并提取基础结构、表格、链接和图片。适用于需要可读文本版本的 Word 文档；旧版 .doc、版式级还原或 Word 内容编辑不应触发本 Skill。
---

# Word 转 Markdown

使用 `scripts/convert.py` 将 `.docx` 转换为 Markdown。转换目标是保留可表达的内容结构，不承诺版式或内容无损还原。

## 执行边界

- 只接受存在的 `.docx` 文件，不把扩展名不同的文件当作 Word 文档处理。
- 默认输出到输入文件旁的同名目录；目录已存在时停止，不自动覆盖或删除内容。
- 只有用户明确同意覆盖时才传入 `--force`。该选项仅覆盖同名生成文件，不清理目录中的其他文件。
- 不自动安装依赖、访问网络或调用办公软件。
- 不擅自删除封面、目录、批注或其他语义内容，也不在转换时改写正文。

## 转换流程

1. 确认输入文件和输出位置；用户未指定时使用默认位置。
2. 执行：

   ```text
   python scripts/convert.py <input.docx> [--output-dir <directory>] [--force]
   ```

3. 检查命令返回码、Markdown 文件、图片目录和警告清单。
4. 抽查标题、段落、列表、表格、链接和图片引用是否可读。
5. 向用户报告输出路径、转换统计和无法可靠处理的内容。

## 支持范围

转换器处理正文段落、常见标题样式、基础有序/无序列表、普通表格、外部超链接、粗体、斜体和嵌入图片。

以下内容可能降级或只产生警告：批注、修订、复杂编号、合并单元格、文本框、页眉页脚、脚注、公式、SmartArt、图表和内嵌附件。发现警告时不得声称转换完整；需要版式级保真时应改用专门的文档工具。

转换完成后，只有用户另外要求整理排版时，才使用 `format-md` 处理生成的 Markdown。