DOC2X使用指南

HTML 图片不显示:路径、外部资源与离线检查

HTML 打开后有文字却没有图片,先核对 img 引用与请求是否成功。用实际 PDF 导出的 HTML 复现外部图片请求被拦截,再比较同图内嵌副本;提供原文件、前后截图和可下载的核对包。

你的文件
已有 HTML 和它实际引用的图片
得到什么
可加载的图片,再检查内容与显示宽度
同一张图片内嵌后,在仍拦截原外部图片请求的浏览器里显示图表
同一张图片内嵌后,在仍拦截原外部图片请求的浏览器里显示图表
本页内容

先定位资源,再决定修正方式

  1. 备份原 HTML,用文本编辑器或浏览器检查图片的 src 类型。
  2. 相对路径核对目录、大小写与后缀;外部地址查看对应请求是否成功;内嵌数据检查是否完整。
  3. 在有使用权限的原图可读取时,恢复正确路径,或在副本中保存/内嵌原图。不要用不相关的图片替换。
  4. 重新打开副本,在目标访问条件下检查图片,再对照原文查看标题、单位、图注与窄屏排版。
看缺图与内嵌资源对照

已有 HTML 时先检查该文件;缺图本身不表示必须重新识别 PDF。

同一张图:外部请求被拦截,与内嵌副本对照

左图有意拦截原生 HTML 中唯一的外部图片请求;右图在同一拦截条件下打开本地后处理副本。两张截图均截取第 4 节到第 5 节开头,内容高度随图像能否加载而变化,没有重绘截图。

原生 HTML:图片请求被拦截
同一 HTML 第4节只显示正文和图注,原外部图像未加载查看原图 ↗
本地副本:同一 JPG 内嵌后可显示
相同拦截条件下内嵌副本显示含 A B C 三点的图表查看原图 ↗
  1. 正常访问原 HTML 时图片为 1061 × 604;拦截该图片地址后自然宽高变为 0,浏览器记录图片请求被拦截。
  2. 仅替换 img src 为含原 JPG 字节的 data URL 后,在相同拦截条件下图片恢复为 1061 × 604。
  3. 恢复图片访问后,未修改的原 HTML 也再次显示图片;四组正文、表格与数学显示一致。
  4. 这里只模拟这个资源地址无法访问,没有测量真实链接失效时间,也没有得出“所有 HTML 图片都会过期”的结论。
  5. 原 PDF 图表顶部的距离单位说明在识别结果中已遗漏,两份 HTML 都未补写。让图片成功加载不会补回识别漏行;请对照原 PDF 检查坐标轴、单位和图注。

本例复用此前自编的两页 LaTeX 演示稿及其已完成的解析,原文标题仍为 “Motion notes: a PDF to LaTeX demo”;本次只导出 HTML,没有重新上传或 OCR。只有一个样例,不代表所有 PDF 的转换效果。 内嵌副本仍有窄屏横向溢出;本地后处理只解决这个样例的图片资源依赖。

先了解这几件事

先查看 img 的 src:相对路径需要配套图片,外部 HTTPS 地址需要成功取回资源,data URL 才把数据写进该引用。本例只拦截原 HTML 的外部图片请求,就出现“正文还在、图不见了”;恢复请求或在副本内嵌同一张图后恢复显示。

复现范围
只拦截一个图片地址并关闭缓存,不是整台浏览器离线。
前后相同
正文、三行表格和十处数学显示均未改变。
副本变化
只替换一个 img src,图片原始字节不变。
仍需核对
图片完整性、窄屏样式与内容识别分别验收。

常用语法,逐段对照

外部地址:只保存引用

<img src="https://cdn.noedgeai.com/...">

形式示意,具体图片路径已省略;实际地址请在原生 HTML 中查看。文件引用该地址,不等于已包含图片字节。

相对路径:图片要和文件一起保存

<img src="images/chart.jpg">

通用写法示意,需有实际 images/chart.jpg 文件。本例原生导出使用外部地址,并非这个目录。

内嵌副本:数据写入 src

<img src="data:image/jpeg;base64,...">

形式示意,省略编码内容。本页完整副本包含同一份 JPG 的全部字节,并未换成另一张图。

按图片引用类型检查

按图片引用类型检查
src 的形式先检查什么该如何验证
images/chart.jpg 等相对路径文件是否一起复制;目录与大小写是否匹配在 HTML 所在目录检查实际图片并重新打开
https://… 外部地址对应请求是否成功,是否被网络或浏览器阻止查看具体图片请求;本例实际复现了请求拦截
data:image/… 内嵌数据编码内容是否完整,目标环境是否允许该资源重新打开文件;本例只用同一张 JPG 验证
图片已出现但信息缺失图片本身与原文是否一致对照标题、坐标轴、单位和图注

先确定问题在资源还是内容

图片自然尺寸为 0 或请求失败时,先修复访问与文件关系。图片已加载但图表说明缺失,则要回到识别内容和裁取范围检查;两种情况的修正方法不同。

外部链接不要只凭一次预览判断

浏览器缓存可能暂时掩盖资源依赖。本例关闭缓存并只拦截该图片请求,原文件立即缺图;解除拦截后恢复。若自己的文件有访问权限或网络限制,应检查对应响应,不把所有失败都解释为过期。

相对路径必须有对应的真实文件

HTML 中写一个目录不会自动生成图片。迁移文件时保留正确的目录关系;改名或移动图像后,同步更新引用并在目标位置打开验证。

内嵌图片会增加 HTML 体积

本例从 33,916 字节增加到 70,448 字节,变化只来自同一份 JPG 的内嵌引用。大图较多时需要权衡文件大小与管理方式;本页不提供任意网页的一键修复器。

图片恢复后,再看窄屏和内容

原 PDF 图表顶部的距离单位说明在识别结果中已遗漏,两份 HTML 都未补写。让图片成功加载不会补回识别漏行;请对照原 PDF 检查坐标轴、单位和图注。 同一个内嵌副本在 312 CSS 像素宽度仍会横向溢出,需另外整理表格或页面样式。

相关官方说明

遇到这些情况

把 HTML 发给别人后只剩文字
检查图片是否为外部地址或遗漏的本地文件。用对方的实际访问条件重新打开,再决定补齐资源。
复制了 data URL,图片仍不显示
检查编码是否被截断、媒体类型是否正确及目标环境的资源限制。本例完整文件可以显示,不保证不完整片段也可用。
图片加载成功,就以为导出已完整
还需对照源文档检查图表标题、单位、小数和图注。本页图片资源恢复后,原来的识别遗漏仍在。

常见问题

HTML 图片不显示,需要重新上传 PDF 吗?

若是路径或外部请求问题,先修复已有文件。本例恢复资源访问后,原 HTML 不改正文就能显示图。

这是不是一次完全离线测试?

不是。测试只拦截原文件的那一个外部图片 URL,并关闭缓存。内嵌副本在同一条件下显示图像;没有切断整个浏览器网络。

内嵌副本是 Doc2X 直接导出的吗?

不是。原生 HTML 单独提供。副本由本地后处理只替换一处图片 src,使用同一张原图。

原生 HTML 的图片一定会过期吗?

本例只验证图片存在外部资源依赖,没有验证失效期限。不要把其他格式的链接规则直接套用到 HTML。

Markdown 转 HTML 也一定使用外部图片吗?

需要看具体入口与实际文件。本站另有 Markdown 编辑器的内嵌图片样例;这与 PDF 解析结果页的 HTML 导出是不同流程。

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