Markdown/Word 文档转换

Markdown/Word 文档转换#

把 Markdown 转成 Word（.docx），或把 Word 转回 Markdown，保留标题、列表、表格和代码块结构。 不带脚本，不联网，不安装程序，只在你指定的位置读写文件。

什么时候用#

• 用户要把 Markdown 文档转成 Word（.docx），或把 Word 文档转回 Markdown / 纯文本。
• 用户要批量转换多个文档，或转换后要保留标题层级、列表、表格、代码块等结构。

怎么做#

Markdown → Word#

1. 先和用户确认输入文件路径和输出文件路径（.docx）。
2. 优先用 pandoc（若已安装）：pandoc 输入.md -o 输出.docx。
3. 没有 pandoc 时，用客户端的文档处理能力（如 python-docx 或内置文档工具）逐项转换：
   • 标题映射为 Word 标题样式（# → 标题 1，## → 标题 2，以此类推）；
   • 段落、有序/无序列表、表格、引用、代码块、图片逐一转换；
   • 代码块使用等宽样式并保留缩进；
   • 行内格式（加粗、斜体、行内代码）尽量保留。
4. 转换后检查：标题层级是否正确、表格是否完整、代码块是否保留、图片是否正常显示；有问题先修复再交付。

Word → Markdown#

1. 先和用户确认输入 .docx 路径和输出 .md 路径。
2. 用客户端的文档处理能力（如 python-docx）读取：
   • 标题按样式映射为 # 层级；
   • 段落、列表、表格转成对应 Markdown 语法；
   • 图片导出到输出目录旁的 images/ 文件夹并在文档中引用；
   • 行内格式尽量保留。
3. 输出后检查结构；页眉页脚、批注等特殊内容先和用户确认取舍。

注意事项#

• 只在用户明确给出的路径读写文件，不扫描用户磁盘，不读取无关文件。
• 不联网、不上传文件、不安装任何程序。
• 转换前先说明大概会生成什么，转换后告诉用户输出位置。