在使用 Markdown(.md)文件编写文档时,经常会遇到图片无法正常显示的问题。这通常由以下几个原因造成:
1. 图片路径错误
Markdown 使用如下语法插入图片:

如果“图片路径”填写错误(如拼写错误、层级错误),图片将无法加载。
2. 相对路径 vs 绝对路径
在本地预览 .md 文件时,很多编辑器或浏览器插件对相对路径支持有限。建议使用相对于 .md 文件的正确相对路径,例如:
- 图片和 .md 文件在同一目录:
 - 图片在子目录 images 中:

3. 本地文件协议限制
直接用浏览器打开本地 .md 文件(file:// 协议)时,出于安全策略,部分浏览器会阻止加载本地图片资源。建议使用支持 Markdown 预览的编辑器(如 VS Code、Typora)或部署到 HTTP 服务下查看。
4. 图片格式或文件损坏
确保图片文件本身未损坏,且为常见格式(如 .png、.jpg、.gif)。
5. 网络图片链接失效
若引用的是网络图片(如 ),需确认该链接可公开访问且未被防盗链限制。
解决建议
- 检查图片路径是否正确;
- 使用 Markdown 编辑器而非浏览器直接打开 .md 文件;
- 将图片转为 Base64 嵌入(适用于小图);
- 部署本地服务器(如使用 Python 的
python -m http.server)进行预览。