Markdown 合并后图片不显示或串图 - 同名文件与相对路径

本页内容

同名图片先分目录，再合并 MD

保存每份原 MD 和图片目录，先核对每张图对应的正文与图注。本例两份资料都有 images/figure.png，但两张图内容不同。
在交付根目录下分别保留 area/images 与 motion/images，放入对应原图；只修改输入 MD 的两条相对路径。
在合并工具选择两份 .md，确认文件顺序、分隔符和标题设置，选择 Markdown 输出，再点击“开始合并”。
看到“已完成”后点击“下载合并文件”。把下载的 MD 与两个图片目录放在同一交付根目录，保持引用关系。
在最终阅读器检查图片是否加载、内容是否对应图注；发送完整目录包，避免只发送 MD 或覆盖同名图。

合并工具选择 .md 文件；图片目录另行保留。下载完整样例后全部解压，再打开 merged.md 或配套的本地预览。

两份中文讲义：同名路径与独立目录对照

2026年10月15日，在中文合并工具实际下载两次。第一次两份输入均引用 images/figure.png；第二次仅把输入引用改为 area/images/figure.png 和 motion/images/figure.png。两份原生合并 MD 保持下载字节。下面将这些结果放入明确的本地目录，用 Pandoc 3.4 阅读。

本地 Pandoc 阅读原生合并 MD，只放入面积课的第一张同名图后，两章都显示蓝色三角形，运动课图注仍写橙色折线 — 本地冲突复现：相同路径都显示蓝色图

本地 Pandoc 阅读第二份原生合并 MD，面积课显示蓝色三角形，运动课显示橙色距离折线，图片分别来自 area 与 motion 目录 — 本地修订预览：独立路径显示各自原图

实际文件与本地摆放分别核对
情况	MD 中的两条引用	本地显示
原始合并 MD	images/figure.png；images/figure.png	只保留第一张同名图时，两处都显示蓝色三角形
路径修订后的合并 MD	area/images/figure.png；motion/images/figure.png	配齐目录后，蓝色与橙色图各自显示

修订后的两条实际图片引用

![面积课：蓝色三角形](area/images/figure.png)

![运动课：橙色距离折线](motion/images/figure.png)

两次均为面积课在前、运动课在后，分隔符 ---、标题级别不变、目录开启，输出 Markdown。还原第二份结果的两条路径后，与第一份全文一致。
冲突预览仅把第一张蓝色图放入 images/figure.png，两处都成功加载它；没有坏图提示，也可能存在图文错配。
修订预览把两张原图放入各自目录，浏览器实际加载两张 960×540 PNG。图片字节与原稿相同，改变的是引用及目录组织。
图 1 应为底 6、高 4、面积 12 的蓝色三角形；图 2 应为时间 4、距离 20、速度 5 的橙色折线。图注不会因串图而自动变化。

输入为自编讲义与本地绘制的示意图。合并工具没有生成、复制或覆盖图片；冲突目录、修订目录、HTML 预览与 ZIP 均由本地整理。未测试 Word/PDF 导出、远程图片、绝对路径、引用式图片、HTML img 或其他阅读器的资源导入。

下载原始两份 MD 与各自图片目录（ZIP）下载修订路径的面积课输入（MD）下载修订路径的运动课输入（MD）下载第一次原生合并 MD（同名路径）下载第二次原生合并 MD（独立路径）下载合并 MD、两张原图与本地预览（ZIP）下载完整输入、输出与核对记录（ZIP）阅读样例制作与范围说明

先了解这几件事

合并 Markdown 通常保留图片引用，不会把原图片一起搬进新文件。两份资料都写 images/figure.png 时，合并后会共用这个相对路径：没有图片会缺图，只放入其中一张则可能串图。先为不同资料保留独立目录，再把引用分别改为 area/images/figure.png、motion/images/figure.png；合并后连同这些目录一起交付。

实际合并: 中文工具处理两份 MD，原始输出 467 字节，路径修订后 479 字节。
变化范围: 两次原生结果只差两条图片引用，其余正文、目录和顺序一致。
图片仍是原图: 蓝色三角形与橙色距离折线各有独立原始 PNG，未重新生成。
预览范围: 图片摆放与 Pandoc 阅读预览在本地复现，非产品 HTML/Word 导出。

完整解压后，目录应与 MD 引用一致

本例可直接核对的交付目录

merged.md
area/
  images/
    figure.png
motion/
  images/
    figure.png

路径相对于 merged.md 的位置。只改变文件名或图注，不会改变图片引用；移动 MD 时同时检查这两条路径。

工具里先合并，再下载 Markdown

第二次实际合并完成时，队列仍是面积课、运动课两份 MD。结果区提供“下载合并文件”；图片资源由自己另行保存。

中文合并工具实际完成两份修订输入，面积课在前、运动课在后，选择 Markdown 输出，结果区显示已完成与下载按钮 — 实际工具结果 · 合并完成后还需点击下载；图片目录另行保留。点击查看完整大图

图片出现了，也可能是另一张图

本例两张图尺寸相同、文件名相同，内容却不同。冲突预览没有加载错误，两处都显示蓝色图；对照章节、颜色与图注，才能发现运动课需要的是橙色折线。

同名图片可以保留在独立目录

area/images/figure.png 与 motion/images/figure.png 是两个不同路径。目录名按自己的资料组织；重命名或移动后同步更新引用，并核对实际阅读器是否支持该路径写法。

先区分缺少文件与路径指错

找不到目标文件时可能显示替代文字或破图；路径存在却指向另一张图时通常仍能显示。两种问题都应从 MD 所在位置解析相对路径，再核对目标文件内容。

完整目录包与单独 MD 的用途不同

单独 MD 便于比较两条路径，完整 ZIP 才同时带有原图。在线编辑器需按自己的资源入口补图或导入目录，不能因本地预览正确就断言它接受相同的整包结构。

详细操作教程

合并 MD：确认顺序、设置并下载

使用合并工具处理正文，再单独核对图片路径与资源目录。

遇到这些情况

不同图注下出现同一张图: 检查引用是否指向同一个相对路径；保留各自原图，分开目录或改名，并同步修改引用。
本机能看，发给别人就缺图: 确认发送的是 MD 与配套目录，而非仅复制正文或 MD。接收方完整解压后，再在自己的阅读器核对。
改了图片说明文字，显示的图没变: 方括号内的替代文字和图注不决定文件位置；检查圆括号中的路径与实际目标图。

常见问题

Markdown 合并会自动把图片打进 MD 吗？

本例工具保留两条图片路径，下载的是 MD 文本，没有同时搬运原图。请单独保存、整理并一起交付资源目录。

多个 MD 合并后为什么出现同一张图片？

不同原稿都可能引用 images/figure.png。合并到同一目录后，两个相对路径指向同一个文件；本例只保留第一张蓝色图时，两处都显示它。

只重命名图片，Markdown 会自动跟着改吗？

本例先人工修改两份输入中的路径，再重新合并。重命名或移动图片时，要同步更新对应引用，检查目标是否存在。

完整 ZIP 可以直接上传合并工具吗？

合并时选择包内的 .md 文件，图片目录另行保留。完整包用于复核和交付，本例没有验证将 ZIP 一次上传为包含图片的合并任务。

内容核对：2026-10-15 · 功能条件与配额以当前产品界面为准

Markdown 合并后，图片不显示或串图