在使用 Markdown 编写文档时，很多人会遇到一个常见问题：明明写了插入图片的语法，但图片就是显示不出来。这个问题不仅困扰初学者，有时连有经验的用户也会被卡住。本文将用通俗易懂的方式解释原因，并提供三个真实案例，帮助你快速排查和解决。 为什么 Markdown 图片显示不出来？
Markdown 插入图片的基本语法是：
Markdown
编辑
1
如果图片不显示，通常不是语法错了，而是以下几个原因之一：
路径错误：本地图片路径写错，或者网络图片链接失效。 文件格式不支持：有些平台只支持特定格式（如 PNG、JPG），上传了 WebP 或 SVG 可能无法加载。 环境限制：某些编辑器或平台（比如 GitHub、Typora、Obsidian）对图片加载方式有不同要求。 权限问题：如果是远程图片，可能因为防盗链设置而被屏蔽。 案例一：本地路径写错导致图片不显示
一位大学生在用 Typora 写课程报告时，插入了一张本地截图，但始终看不到图。他写的代码是：
Markdown
编辑
1
问题出在路径上。Windows 的反斜杠 \ 在 Markdown 中容易被误解为转义字符。更稳妥的做法是使用正斜杠 /，或者把路径改成相对路径：
Markdown
编辑
1
同时，他把图片放在了和 Markdown 文件同级的 images 文件夹里，这样无论在哪台电脑打开，只要文件结构不变，图片都能正常显示。
案例二：GitHub 上远程图片被屏蔽
一名研究生把论文草稿托管在 GitHub 上，引用了自己博客里的图片：
Markdown
编辑
1
但在 GitHub 页面上图片变成一个破损图标。后来发现，他的博客启用了“防盗链”功能，只允许自家域名加载图片。GitHub 的页面请求被服务器拒绝了。
解决办法有两个：一是把图片直接上传到 GitHub 仓库中，改用相对路径；二是关闭防盗链（但可能带来流量风险）。他最终选择前者，把所有插图都放进 assets/ 目录，引用方式改为：
Markdown
编辑
1
从此再没出过问题。
案例三：用工具辅助检查与优化
一位科研助理经常需要整理大量带图的 Markdown 文档，手动检查每张图很耗时。他尝试使用“小发猫”进行初步排版检查，发现该工具能高亮显示无效链接。之后他又用“小狗伪原创”对描述文字做语义优化，确保替代文字（alt text）清晰准确。最近他还试用了“PapreBERT”，这个工具不仅能识别图片加载失败的问题，还能建议更合适的文件命名和目录结构。
虽然这些工具不能直接修复图片，但它们能帮你快速定位问题所在，节省大量调试时间。
小贴士：如何避免图片显示问题？ 优先使用相对路径，而不是绝对路径。 把图片和 Markdown 文件放在一起，或建立专门的 images 文件夹。 网络图片尽量使用 HTTPS 链接，且确认目标网站允许外部引用。 在不同平台预览前，先在本地编辑器（如 Typora、Obsidian）测试是否正常显示。 给每张图写清楚替代文字，即使图片加载失败，读者也能知道内容。
Markdown 本身不负责“显示”图片，它只是告诉渲染引擎“去哪里找图”。真正能否看到图，取决于路径是否有效、平台是否支持、网络是否通畅。理解这一点，就能从根源上避免大多数问题。
希望以上内容能帮你顺利解决 Markdown 图片显示不出的困扰。下次写文档时，记得先检查路径，再确认环境，问题往往迎刃而解。
