Markdown 怎么转 Word DOCX？保留标题、表格、代码和本地图片

技术文档、README、课程笔记和产品说明常用 Markdown 编写，但交付时对方可能只接受 Word。直接把预览网页复制进 Word，有时能保留粗体和标题，却也容易出现列表断掉、代码块变形、表格宽度混乱、图片只剩一个网络地址的问题。

Markdown 转 Word DOCX 工具会在浏览器本地解析 Markdown，生成真正可编辑的 .docx。标题、段落、列表、引用、表格、链接、代码块和匹配到的本地图片会写入 Word 文档结构，而不是把整页做成截图。

“生成 DOCX”和“复制网页”有什么区别

Word 文档内部是一个包含 XML、关系文件和媒体资源的 ZIP 容器。一个可靠的转换器需要把 Markdown 结构映射成 Word 的段落、文本样式、编号、表格、超链接和图片关系。

复制网页依赖浏览器和 Word 临时协商 HTML 样式，结果容易受系统、剪贴板和目标软件影响。生成 DOCX 则可以明确写入标题级别、列表关系和媒体文件，后续仍能在 Word、WPS 或 LibreOffice 中编辑。

不过 DOCX 不是网页浏览器。CSS 网格、JavaScript 组件、复杂 HTML 和像素级布局没有一一对应关系。转换目标应该是结构清楚、方便继续排版，而不是让 Word 与网页逐像素相同。

哪些 Markdown 内容可以保留

常用 Markdown 和 GFM 元素可以稳定映射：

• # 到 ###### 标题；
• 普通段落、粗体、斜体和删除线；
• 有序、无序列表与任务项；
• 行内代码和围栏代码块；
• 引用、分隔线和超链接；
• GFM 表格；
• 本地 JPG、PNG、GIF、BMP 图片。

原始 HTML 会按可读文字处理，不会作为可执行网页嵌入 Word。脚本、表单、视频、iframe 和复杂 CSS 不会保留。数学公式、脚注域、自动目录、交叉引用、分节页眉页脚和出版级分页也不在首版范围内。

如果文档严重依赖这些功能，先导出基础 DOCX，再在 Word 中完成最终排版，比伪装成“百分之百还原”更可靠。

本地图片怎样正确进入 Word

Markdown 常写：

![安装界面](images/install.png)

浏览器不能凭这段相对路径读取你电脑上的项目目录。因此除了上传 .md，还要把引用的图片一起选择。工具会按路径末尾和文件名匹配，例如 images/install.png 可以匹配上传的 install.png。

为了减少误配，同名图片最好改成不同文件名。若不同目录都有 cover.png，浏览器上传后未必保留完整目录关系，转换器无法知道 Markdown 原本指向哪一张。

HTTP/HTTPS 远程图片不会自动下载。这既避免无意访问追踪地址，也避免受跨域、过期链接和授权限制影响。需要嵌入远程图片时，应先确认版权与来源，把图片保存到本地后与 Markdown 一起上传。data URI 图片则可以直接解析，但过大的内嵌数据会让源文件和 DOCX 都明显膨胀。

为什么导出后字体和分页会变化

Word、WPS、LibreOffice 和 Google Docs 使用不同的排版引擎。即使打开同一个 DOCX，替代字体、行距、页边距、表格算法和图片缩放也可能略有不同。对方电脑没有你的字体时，换行位置自然会改变。

工具可以选择 A4 或 Letter 纸张，并提供基础标题和正文样式，但不会把每一行锁死。需要正式交付时，应在目标软件里检查：

• 标题是否重复或缺失；
• 目录需要哪些标题级别；
• 表格是否超出页面；
• 长代码行是否需要换行或缩小字号；
• 图片是否清楚、尺寸是否合适；
• 段落与分页是否需要手工调整。

如果 Markdown 第一行已经是文档标题，又启用了“把标题放在正文前”，Word 中会出现两次标题。二选一即可。

表格、列表和代码块的常见问题

Markdown 表格通常没有固定列宽。转换器会生成可编辑表格，但内容很长时，Word 可能重新分配宽度。可以在导出后使用“根据窗口调整表格”，或改用横向页面和更短字段名。

列表嵌套层级越深，不同 Markdown 解析器之间差异越明显。正式文档尽量保持结构简单，尤其不要用大量空格混合 Tab。任务项会以可读的勾选符号表达，不会变成 Word 的交互式内容控件。

代码块会使用等宽字体和背景样式，但不会执行语法高亮引擎。对于交付文档，稳定显示往往比把几十种语言的网页高亮 CSS 搬进 Word 更重要。

推荐的导出步骤

先在编辑区载入 Markdown，检查实时预览是否符合预期。若有本地图片，把图片一并上传并确认“已匹配”数量；页面提示缺失或远程图片时，先处理路径，不要等下载后才发现空位。

填写文件名、文档标题和作者，选择纸张，再生成 DOCX。下载后必须在目标软件中打开一次，抽查开头、长表格、图片、代码块和结尾。需要给网页或知识库使用时，也可以下载独立 HTML，但 HTML 与 DOCX 服务的场景不同，不要用一种格式替代另一种格式的验收。

如果只是想查看或清理 Markdown，可使用 Markdown 预览工具；需要在 HTML 与 Markdown 之间整理内容，可使用 HTML / Markdown 双向转换器。

总结

Markdown 转 Word 的重点不是把页面拍成图片，而是把文档结构写进真正的 DOCX。标题、列表、表格、链接、代码和本地图片都要按 Word 能编辑的方式生成；远程图片、复杂 HTML、公式和出版级版式则有明确边界。先解决图片匹配，导出后在目标软件抽查，得到的文档才适合继续修改和交付。