Markdown转HTML后图片为什么没显示?先看src路径相对哪一页
Markdown转出来的HTML中已经有img标签,发布后却显示不出图片,先不要把问题归为转换器漏图。转换图片语法与把图片文件放到可访问的位置,是两个不同环节。
下面在Markdown转HTML中只测试路径怎样写入源码。样例文件名是虚构的,本次没有上传这些图片,也没有把“生成了img”当成图片地址真实存在的证明。
相对路径会保留在src里
在“Markdown 输入”放入这段文字:。右侧会自动更新HTML源码,不需要再点转换按钮。

本次结果是:
<p><img src="images/demo.png" alt="演示图" title="相对图片"></p>
src 指向 images/demo.png,alt 是演示图,title 是相对图片。工具没有把虚构文件名上传,也没有把它改成一个固定的公网地址。右侧显示的是源码文本,不是完整网页的图片预览。
相对路径的最终位置由放置HTML的文档基准地址决定。例如,一个页面在 https://example.com/docs/start.html,在没有其他基准声明的情况下,images/demo.png 对应的是 https://example.com/docs/images/demo.png。把同一段HTML移到另一层目录,目标地址也可能随之改变。
这些地址只是说明解析规则,本文没有请求示例图片。真正发布时,必须让图片文件与最终地址对应,并检查服务器是否允许访问;转换器不知道你的部署目录怎样安排。
开头的斜杠表示另一种位置
第二组改成 。

本次结果里的src是 /assets/demo.png。在通常的HTTP网页中,这样的路径以当前站点根路径为起点,不再跟着文章所在的 /docs/ 目录走。它适合站点明确把资源部署在根路径的情况,不能用于猜测任意平台都会提供这个目录。
站点如果部署在子路径下,也要单独核对。原来在项目目录中能打开的资源,搬到域名根目录后未必还存在。页面中还可能设置HTML的base基准地址,遇到这类情况,应查看浏览器最终解析出的完整图片地址。
本地双击HTML预览与服务器上访问也不能混为同一环境。特别是以斜杠开头的路径,在本地文件协议下并不自动指向你的项目文件夹。要确认线上表现,应在实际发布地址打开开发者工具查看请求。
文件名含空格时,看实际输出
第三组用尖括号包住带空格的目标:。

本次src为 images/demo%20chart.png,空格变成百分号编码。尖括号帮助明确这是一段完整目标,后面的标题没有被误并入文件名。它不意味着服务器上应该把文件实际重命名为含 %20 三个字符的名字。
排查时应看浏览器请求的URL、返回状态和内容类型,再核对实际文件名及大小写。某些环境对文件名大小写敏感,本地预览正常并不能替代线上检查。复制工具生成的完整源码时,也要确认编辑器没有把img标签作为普通文字显示。
站内批量找失效地址,可以配合死链检测查看对应页面链接的响应;不过链接检测的范围与图片资源检查是否相同,需要以工具实际支持为准。对本文的图片问题,最直接的证据仍是最终网页中那一个src实际请求到了什么。