Markdown 图片转 Word 后不显示？本地图片与 ZIP 打包指南

Markdown 文档在编辑器中显示正常，但转换成 Word 后，部分图片却突然消失。文字、标题和表格都还在，DOCX 中对应位置可能只剩空白、错误提示，或者一段图片替代文字。

大多数情况下，图片文件本身并没有损坏。真正的问题是：转换程序无法在 Markdown 指定的位置找到图片。本地图片要正常插入 Word，Markdown 中的路径和 ZIP 压缩包里的实际目录结构必须保持一致。

为什么 Markdown 本地图片会丢失

一条常见的 Markdown 图片语法通常包含三个部分：

![季度收入图表](images/revenue-chart.png)

• 替代文字：季度收入图表
• 目录：images
• 文件名：revenue-chart.png

替代文字并不包含图片数据，它只是对图片内容的描述。文档转换时，真正的图片文件必须存在于路径所指向的位置。

本地图片丢失通常由以下原因造成：

• 上传的 ZIP 中根本没有包含图片文件。
• Markdown 中写错了图片所在目录。
• Markdown 文件名与真实文件名不完全一致。
• 图片使用了只在作者电脑上有效的绝对路径。
• 压缩时意外增加或减少了一层目录。
• 路径中混用了斜杠和反斜杠。
• 图片重命名后，没有同步更新 Markdown。

使用相对路径，不要使用电脑绝对路径

相对路径以 Markdown 文件所在位置为起点，不依赖 Windows 盘符、macOS 用户目录或某一台电脑的专属文件夹。

推荐写法

![系统架构](images/system-architecture.png)

不推荐写法

![系统架构](C:\Users\Alex\Desktop\report\images\system-architecture.png)

这个 Windows 路径只在原电脑上有效，在线转换服务无法访问用户桌面目录。类似的 macOS 路径，例如 /Users/alex/Documents/report/image.png，也存在同样的问题。

推荐的 ZIP 目录结构

对大多数文档来说，最简单的做法是把 Markdown 文件放在压缩包根目录附近，再把所有图片放进一个名称清晰的子目录。

project-report.zip
├── project-report.md
└── images
    ├── cover.png
    ├── architecture.png
    ├── test-results.jpg
    └── deployment-flow.svg

此时，project-report.md 中的图片引用可以写成：

![项目封面](images/cover.png)

![系统架构](images/architecture.png)

![测试结果](images/test-results.jpg)

![部署流程](images/deployment-flow.svg)

这种结构容易查看，也方便在不同电脑之间移动，不容易因为目录层级过深而写错路径。

小心 ZIP 中多出一层目录

一个常见错误是：用户压缩了外层父目录，而不是直接压缩 Markdown 文件和图片目录。

上传前，应先打开 ZIP，确认 Markdown 文件和图片目录之间的位置关系与压缩前完全一致。

文件名大小写必须一致

某些本地系统会把大小写不同的文件名当作同一个文件，但服务器环境可能会把它们识别为两个不同文件。

应将它们视为两个不同文件名。建议尽量统一使用小写文件名，图片改名后也要同步修改 Markdown。

使用容易维护的图片文件名

简单、统一的文件名可以减少路径错误，也便于后续维护。

空格和中文文件名在很多环境中并非一定无效，但由小写字母、数字和连字符组成的文件名，更容易输入、比较、传输和排查。

不要使用本地 file URL

以下路径仍然只指向作者自己的电脑：

![流程图](file:///C:/Users/Alex/Documents/diagram.png)

即使 ZIP 中包含同名图片，也不会自动修复这条路径。应把它改为相对路径：

![流程图](images/diagram.png)

网络图片应该怎样处理

网络图片使用 HTTPS 地址，而不是本地路径：

![公开流程图](https://example.com/images/diagram.png)

网络图片存在另一类风险：地址可能过期、要求登录、禁止外部请求、发生多次跳转，或者返回网页而不是真实图片。

对正式文档而言，在获得合法使用权限后，把图片副本放进 ZIP，通常更稳定，也更便于以后重复生成同一份文档。

上传前的检查流程

1. 用文本编辑器打开 Markdown。搜索所有 ![ 图片引用。
2. 列出全部图片路径。确认每一个目标文件真实存在。
3. 替换绝对路径。改成相对于 Markdown 文件的路径。
4. 检查拼写和大小写。逐字比较路径与真实文件名。
5. 创建 ZIP。保持 Markdown 与图片目录之间的原有关系。
6. 上传前打开 ZIP。不要默认认为压缩工具一定保留了预期结构。
7. 转换后检查 DOCX。逐张确认图片内容、大小和清晰度。

文件整理完成后，应通过

Markdown 转 Word 工具

上传包含 Markdown 和本地图片的 ZIP，而不是只上传单独的 Markdown 文件。

常见问题对照表

常见问题

最终检查清单