SKILL.md
2.1 KB查看排版效果| 1 | --- |
| 2 | name: md-doc-convert |
| 3 | description: "把 Markdown 转成 Word(.docx),或把 Word 转回 Markdown,保留标题、列表、表格和代码块结构。不带脚本,不联网,只读写用户指定的文件。" |
| 4 | --- |
| 5 | |
| 6 | # Markdown/Word 文档转换 |
| 7 | |
| 8 | 把 Markdown 转成 Word(.docx),或把 Word 转回 Markdown,保留标题、列表、表格和代码块结构。 |
| 9 | **不带脚本,不联网,不安装程序,只在你指定的位置读写文件。** |
| 10 | |
| 11 | ## 什么时候用 |
| 12 | |
| 13 | - 用户要把 Markdown 文档转成 Word(.docx),或把 Word 文档转回 Markdown / 纯文本。 |
| 14 | - 用户要批量转换多个文档,或转换后要保留标题层级、列表、表格、代码块等结构。 |
| 15 | |
| 16 | ## 怎么做 |
| 17 | |
| 18 | ### Markdown → Word |
| 19 | |
| 20 | 1. 先和用户确认输入文件路径和输出文件路径(.docx)。 |
| 21 | 2. 优先用 pandoc(若已安装):`pandoc 输入.md -o 输出.docx`。 |
| 22 | 3. 没有 pandoc 时,用客户端的文档处理能力(如 python-docx 或内置文档工具)逐项转换: |
| 23 | - 标题映射为 Word 标题样式(`#` → 标题 1,`##` → 标题 2,以此类推); |
| 24 | - 段落、有序/无序列表、表格、引用、代码块、图片逐一转换; |
| 25 | - 代码块使用等宽样式并保留缩进; |
| 26 | - 行内格式(加粗、斜体、行内代码)尽量保留。 |
| 27 | 4. 转换后检查:标题层级是否正确、表格是否完整、代码块是否保留、图片是否正常显示;有问题先修复再交付。 |
| 28 | |
| 29 | ### Word → Markdown |
| 30 | |
| 31 | 1. 先和用户确认输入 .docx 路径和输出 .md 路径。 |
| 32 | 2. 用客户端的文档处理能力(如 python-docx)读取: |
| 33 | - 标题按样式映射为 `#` 层级; |
| 34 | - 段落、列表、表格转成对应 Markdown 语法; |
| 35 | - 图片导出到输出目录旁的 `images/` 文件夹并在文档中引用; |
| 36 | - 行内格式尽量保留。 |
| 37 | 3. 输出后检查结构;页眉页脚、批注等特殊内容先和用户确认取舍。 |
| 38 | |
| 39 | ## 注意事项 |
| 40 | |
| 41 | - 只在用户明确给出的路径读写文件,不扫描用户磁盘,不读取无关文件。 |
| 42 | - 不联网、不上传文件、不安装任何程序。 |
| 43 | - 转换前先说明大概会生成什么,转换后告诉用户输出位置。 |
文件内容是平台检查时读出的文本,只供查看。平台不会运行包里的任何脚本或程序。

