Markdown图片显示不出来？原因与解决方法大全
在使用 Markdown 编写文档时，经常会遇到图片无法正常显示的问题。本文将系统梳理常见原因，并提供实用的解决方案。
1. 检查 Markdown 图片语法是否正确
标准的 Markdown 插入图片语法如下：
请确保：
- 以
! 开头
- 紧跟方括号
[] 内是替代文本（alt）
- 圆括号
() 内是图片的 URL 或相对路径
2. 图片路径问题
本地路径
如果图片存储在本地，请注意：
- 某些 Markdown 渲染器（如 GitHub）不支持本地绝对路径
- 建议使用相对路径，例如：
- 确保文件路径和文件名大小写完全匹配（尤其在 Linux/macOS 系统）
网络路径
使用在线图片时，请确认：
- URL 可直接访问（在浏览器中打开能显示图片）
- 链接以
http:// 或 https:// 开头
- 目标服务器未禁止外链（CORS 或防盗链策略）
3. 渲染环境限制
不同平台对 Markdown 的支持程度不同：
- GitHub / GitLab：仅支持仓库内的相对路径或公开网络图片
- Typora / Obsidian：支持本地路径，但需注意文件结构
- 网页端编辑器：可能因安全策略屏蔽本地文件
4. 其他常见问题
- 图片格式不被支持（推荐使用
.png、.jpg、.gif）
- Markdown 文件编码问题（建议使用 UTF-8）
- 缓存导致旧内容未刷新（尝试强制刷新页面）
5. 调试建议
若仍无法显示，可尝试以下方法：
- 在浏览器开发者工具中查看网络请求，确认图片是否 404
- 临时替换为一个已知有效的网络图片测试语法
- 使用 HTML 标签作为备选方案：
<img src="图片地址" alt="描述" width="500">