本页内容
先修图片引用，再选择原图，最后打开成品
- 保留原MD和images目录，先对照实际文件名。本例图片为“课程 图1.png”，中文与空格都是文件名的一部分。
- 把自编或自己的源码放入编辑器，对照预览。若图片语法仍作为文字显示，先检查目标阅读器支持的引用写法。
- 本例改为尖括号包住路径后，出现1张图片需要补齐；这时点击选择原图片，并通过文件选择器选入同名PNG。
- 确认缺图提示消失且图的内容对应图注。本例核对1600×1000图中底6、高4和面积12，以及正文结束标记。
- 点击导出文件，选择当前可用HTML并导出，再重新打开实际文件。本例HTML内嵌原PNG；继续迁移原MD时仍需一起保留图片目录。
先保留已有文稿。单纯改路径写法不会生成图片文件；临时草稿不代替MD、原图与导出备份。
同一张图：语法原样显示、引用已识别、补齐后显示
2026年10月16日，在公开编辑器的未登录临时页用三种自编路径写法核对。下方按顺序保留实际页面：未转义空格写法仍显示为文字；尖括号写法触发缺图提示；选入同名中文空格PNG后原图显示，并实际导出HTML一次。
| 输入写法 | 本次观察 | 本轮完成到哪一步 |
|---|---|---|
| images/课程 图1.png，未包尖括号 | 本例预览原样显示整条图片语法 | 确认语法未作为图片处理 |
| <images/课程 图1.png> | 识别为图片，先提示需要原图 | 选择同名PNG，实际导出HTML并重新打开 |
| images/%E8%AF%BE%E7%A8%8B%20%E5%9B%BE1.png | 同样进入图片补齐状态，提示编码路径 | 仅确认引用识别；未在此变体补图导出 |
- 图片复用已公开的自编图表，只复制并改名为“课程 图1.png”，101,179字节保持。中文文件名没有改成英文，也没有重新OCR或翻译。
- 尖括号样例识别引用后仍需真实原图。实际文件选择器选入一次PNG，缺图提示消失，正文、图注与DOC2X-PATH-SPACES-END保留。
- 实际HTML为141,219字节，只有1张PNG data URL；解码后与原PNG完全一致，没有file:、blob:或images/图片依赖。HTML原字节未改。
- 本次HTML已通过本地HTTP在浏览器重新打开，图片、标题、图注与结束标记均在。只证明本例成品，不推断Word/PDF、其他浏览器或所有离线条件。
这是一份自编路径练习和已公开合成图片，不是OCR、翻译或模型准确率测试。完整补图与HTML导出仅验证尖括号变体，百分号编码变体只确认引用识别。截图为实际应用内浏览器页面，未重绘；核对ZIP为本地整理，内含未改写的实际HTML和正确目录。
先了解这几件事
路径含空格时，先确认图片语法有没有被识别。本例 `` 在预览里仍是文字；改为 `` 后被识别为图片，但还需要选择正确原图。补入同名PNG才显示，实际HTML也包含同一份图片字节。修语法、提供资源和检查导出，是三个分别确认的步骤。
- 语法状态
- 原样显示图片语法时，先检查括号、空格与目标阅读器支持。
- 资源状态
- 出现缺图提示表示引用已识别，但图片还不一定可读取。
- 本例输出
- 未改写的141,219字节HTML，含1张与原图字节相同的PNG。
- 验证范围
- 未登录应用内浏览器的单图补齐和HTML导出；其他格式与阅读器另验。
只改写法不会自动补出图片文件
本例原样显示为文字的写法
本次Doc2X预览未把这条作为图片处理，不由此推断所有Markdown阅读器的行为。
本次完成补图与导出的写法
尖括号包住路径后被识别为图片；原图仍要随MD保留或在编辑器补入。
编码变体：本次只核对到缺图提示
不能把出现补图提示当作已完成补图或导出，本轮没有验证这个变体的完整流程。
先按看到的状态定位问题
| 预览或文件状态 | 优先检查 | 本例的处理 |
|---|---|---|
| 整条还是普通文字 | 图片语法、路径空格和阅读器支持 | 改为尖括号路径，先确认被识别 |
| 已经出现缺图或需要原图提示 | 图片文件是否真正可读取、是否对应当前引用 | 选择中文空格文件名的正确原PNG |
| 图片出现了，准备导出 | 图片与图注是否相符，导出内容是否完整 | 导出HTML，再核对原PNG字节和结束标记 |
| 只带走了原MD | 对应目录和图片是否一起保存 | 保留images/课程 图1.png及原MD |
Markdown图片语法原样显示，先检查是否被识别
本例未包尖括号的空格路径在右侧仍是文字，没有进入原图补齐。若引用都未识别，反复选择图片不是第一步；先检查括号、路径边界和目标阅读器支持的写法，再观察预览状态。
中文文件名与空格是两件事
这次保留中文文件名和空格，使用尖括号路径后完成补图与HTML导出，没有靠统一改成英文文件名解决。其他字符、不同目录和阅读器仍要分别验证，不能用这个例子保证任意文件名都可直接使用。
尖括号或百分号编码不会生成原图片
引用写法描述从哪里找资源，不携带磁盘上的文件。尖括号样例也先提示缺原图，直到实际选择对应PNG才显示。编码变体在本轮只确认到引用识别，不把它作为另一个已经成功导出的样例。
最终HTML带图，与原MD带图分别判断
这次补图后的实际HTML写入同一PNG的全部字节；原始尖括号MD依旧指向images目录。分享HTML成品与继续编辑原MD是不同任务，后者请保留原图及目录关系，不只复制几行源码。
从临时预览到文件，按真实内容验收
先看图片是否对应图注，再在实际成品核对标题、数字和末尾内容。本例保留面积12与结束标记，HTML重开后可见；没有测试Word/PDF或其他Markdown软件，使用它们时需要另外检查。
常见问题
Markdown图片路径有空格，该怎样写？
本例用尖括号包住完整路径后，被识别为图片引用：。之后仍要补齐正确原图；不同阅读器的支持请用自己的文件核对。
Markdown中文图片名必须改成英文吗？
本例没有改成英文，中文与空格文件名保留，选择同名PNG后实际导出HTML。不能据此保证所有文件名或软件都相同，但不必先把中文本身当成故障原因。
改成%20之后，就一定有图片了吗？
不能。编码只影响引用写法，原图仍需可读取。本轮编码变体只确认到补图提示，没有完成该变体的选图和导出。
加了尖括号仍显示缺图，是什么原因？
本例是引用已经识别，但还没提供图片字节。按提示选择正确原图片，再确认图的内容对应当前段落；写对路径不代表图片已经随文字一起进入编辑器。
怎样确认导出的HTML真的带上了图？
打开实际文件检查图片、正文和结尾。本例进一步解码HTML内的一张PNG，字节与原101,179字节PNG一致；这个验证仅限本例HTML，不代替其他格式验收。
内容核对：2026-10-16 · 功能条件与配额以当前产品界面为准