1.9 KiB
1.9 KiB
name, description
| name | description |
|---|---|
| docx-to-md | 将 Word .docx 文档转换为 Markdown，并提取基础结构、表格、链接和图片。适用于需要可读文本版本的 Word 文档；旧版 .doc、版式级还原或 Word 内容编辑不应触发本 Skill。 |
Word 转 Markdown
使用 scripts/convert.py 将 .docx 转换为 Markdown。转换目标是保留可表达的内容结构，不承诺版式或内容无损还原。
执行边界
- 只接受存在的
.docx文件，不把扩展名不同的文件当作 Word 文档处理。 - 默认输出到输入文件旁的同名目录；目录已存在时停止，不自动覆盖或删除内容。
- 只有用户明确同意覆盖时才传入
--force。该选项仅覆盖同名生成文件，不清理目录中的其他文件。 - 不自动安装依赖、访问网络或调用办公软件。
- 不擅自删除封面、目录、批注或其他语义内容，也不在转换时改写正文。
转换流程
-
确认输入文件和输出位置；用户未指定时使用默认位置。
-
执行：
python scripts/convert.py <input.docx> [--output-dir <directory>] [--force] -
检查命令返回码、Markdown 文件、图片目录和警告清单。
-
抽查标题、段落、列表、表格、链接和图片引用是否可读。
-
向用户报告输出路径、转换统计和无法可靠处理的内容。
支持范围
转换器处理正文段落、常见标题样式、基础有序/无序列表、普通表格、外部超链接、粗体、斜体和嵌入图片。
以下内容可能降级或只产生警告：批注、修订、复杂编号、合并单元格、文本框、页眉页脚、脚注、公式、SmartArt、图表和内嵌附件。发现警告时不得声称转换完整；需要版式级保真时应改用专门的文档工具。
转换完成后，只有用户另外要求整理排版时，才使用 format-md 处理生成的 Markdown。