OmniDocMarkdown转Word图片不显示怎么办
Markdown转换为Word后图片变成红叉、空白或直接消失，多数是路径写错、图片是网络链接或没有嵌入文件。本文按症状定位原因，给出逐项排查和修复步骤，并说明怎样避免再次出错。
如果你用 Markdown 写了报告、课程笔记或论文草稿，转换成 Word 后却发现图片变成了红叉、空白框，或者干脆不见了，这篇文章就是为这种情况写的。这类问题非常常见，但原因通常不复杂：要么图片路径在转换时找不到，要么图片根本没有被嵌入到输出文件里。
读完之后，你应该能判断自己属于哪一种情况，并用较少的改动让图片在 Word 里正常显示。下面先给出结论，再按症状定位原因，然后逐项排查修复，最后说明怎样写 Markdown 和导出，避免下次再出错。
图片不显示，要重新插入还是修路径？一句话结论
多数情况下只需修正图片路径或嵌入方式，不必重新插图。先看图片文件是否还在原位置，再决定下一步。
| 你的情况 | 推荐做法 | 原因 |
|---|---|---|
| 图片和 .md 文件在同一文件夹，只是路径写错 | 修正路径后重新转换 | 改一处语句比重新插图快，原图也不会丢 |
| 图片来自网络链接，而且链接打不开 | 下载到本地，改成相对路径 | 链接失效或需要登录时，转换过程无法获取图片 |
| 图片分散在多个文件夹里 | 统一放到一个 images 文件夹 | 路径集中后更容易检查，也方便整体迁移 |
| 只需要一份可继续编辑的 Word 文件 | 使用 OmniDoc 转换，或在 UniDoc 网页编辑器（app.unidoc.top）中打开后导出 | 图片随输出文件保留，减少手动重插 |
先判断是哪一种问题
不同症状对应的原因不同，先对照下表，可以少走很多弯路。
| 症状 | 常见原因 | 怎么确认 |
|---|---|---|
| Word 中显示红叉或“无法显示图片”的提示 | 路径错误，或图片文件已被移动、改名 | 对照 Markdown 里的路径和图片的实际位置 |
| 图片位置是一片空白，没有任何提示 | 图片是网络链接，转换时没能取到内容 | 在浏览器中直接打开该链接，看能否正常显示 |
| Markdown 预览里能看到图，转换后消失 | 图片语法写得不标准，比如少了感叹号或方括号、圆括号不配对 | 逐行检查图片语句是否符合标准写法 |
| 图片显示正常，但把文件发给别人后就坏了 | 图片只是链接，没有嵌入文件 | 把 Word 文件复制到另一个文件夹打开，看图片是否还在 |
| 图片格式特殊，如 WebP 或较少见的格式 | 输出环节对该格式支持有限 | 用图片软件另存为 PNG 或 JPG 后重新转换 |
逐项排查和修复
建议按下面的顺序检查，先易后难，大多数问题在前四步就能解决。
- 打开 .md 文件，搜索英文感叹号，找到所有图片语句，逐条记下它们引用的路径。
- 确认每个路径指向的图片确实存在，并注意文件名的大小写、空格和中文字符是否完全一致。
- 把绝对路径（例如 D 盘下的完整位置）改成相对路径，比如 images/fig1.png。绝对路径只在你自己的电脑上有效，换一台机器就会失效。
- 把网络图片下载到项目的 images 文件夹，再把对应语句改成本地相对路径。
- 检查图片格式，不常见的格式另存为 PNG 或 JPG，再更新 Markdown 里的文件名。
- 重新转换，打开 Word 逐张查看图片。如果仍有缺失，只针对这几张图重复前面的步骤即可。
网络图片：先下载，再引用
网络图片容易在转换时出问题。链接可能过期，也可能需要登录或限制了访问来源。稳妥的做法是先在浏览器中打开链接确认能看到图，再右键保存到本地，然后按第三步的方式改成相对路径。如果图片来自别人的文档，还要注意版权与授权，只在有权使用的前提下保存和转换。
链接而非嵌入：移动文件后图片消失
有时 Word 中的图片能正常显示，但文件一移动就坏了。这通常是插入时只保存了图片的位置信息，而没有把图片数据放进文档。解决办法是重新插入图片，并确保它以嵌入方式存在于文档中。另一个检查方法是把 Word 文件复制到桌面或其他文件夹再打开，如果图片仍然完整，就说明已经嵌入成功。
怎样避免下次再出现
- 写作时统一使用相对路径，并把所有图片放进同一个 images 文件夹。
- 发送或备份时，连同 images 文件夹一起打包，不要只发 .md 文件。
- 截图优先保存为 PNG，避免使用容易出现兼容问题的小众格式。
- 转换前先在编辑器中预览一遍，确认每张图都能正常打开。
- 转换后核对图片数量与原文是否一致，并检查图注位置有没有错位。
❓ 常见问题（FAQ）
1. 图片显示了，但比原来小很多，怎么办？
这通常是 Word 页面宽度限制或导出时的缩放导致的。在 Word 中点击图片，拖动四角的控制点即可调整大小。
2. 为什么 Markdown 预览里图片正常，转成 Word 就不行？
预览器一般会以当前文件所在的文件夹为基准查找图片，而转换工具可能按另一个位置查找，或要求图片以嵌入的方式存在。检查路径的写法和图片是否与 .md 文件放在约定的相对位置，通常就能解决。
3. 图片链接来自网络图床，能直接用吗？
不建议直接依赖。链接可能过期、被限制访问，或在转换时无法获取。下载到本地再引用更稳定。
4. 转换后要不要逐张检查？
建议检查。对照原文的图片数量、顺序和图注，能及时发现遗漏或错位，尤其是论文和正式报告，核对一遍更安心。
📝 总结
Markdown 转换为 Word 时图片不显示，多数是路径错误、网络链接失效或图片没有嵌入造成的，先判断原因再修复，通常不需要重新插图。统一使用相对路径、网络图片先下载到本地，并在转换后逐张核对，就能让图片在 Word 中稳定显示。
