吴佳晗1. 为什么图片排版在Markdown中如此重要？
写技术文档时，图片往往比文字更能直观地说明问题。但很多开发者都有过这样的经历：精心准备的文档在不同平台展示时，图片要么显示不出来，要么大小错乱，甚至直接破坏整个页面的布局。这种情况在跨平台协作时尤为常见，比如你写的Markdown文档在本地预览正常，上传到GitHub后图片却全部失效；或者在公司内部Wiki上排版精美的图片，发布到博客平台后变得乱七八糟。
我刚开始写技术博客时就踩过不少坑。有一次花了两天时间整理的项目文档，因为使用了绝对路径，同事打开后完全看不到图片。还有一次为了赶时间，直接用默认尺寸插入截图，结果在移动端查看时图片超出屏幕范围，用户体验极差。这些经历让我深刻认识到：掌握Markdown图片处理的正确方法，是每个技术写作者必备的基础技能。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 图片路径的选择：绝对路径 vs 相对路径
2.1 绝对路径的适用场景与风险
绝对路径是指包含完整目录结构的路径，比如C:\Users\Project\images\demo.png或https://example.com/images/demo.png。它的优点是直观明确，在本地开发环境中使用非常方便。我曾经习惯用绝对路径，因为直接复制文件属性就能得到完整路径，不需要考虑相对位置。
但绝对路径有个致命缺陷：可移植性差。当我把文档分享给同事，或者部署到服务器时，除非对方电脑上有完全相同的目录结构，或者图片托管在完全相同的URL，否则图片必然加载失败。有一次我把项目文档打包发给客户，结果因为图片路径指向我本地D盘，客户那边全部显示为破损图标，场面十分尴尬。
2.2 相对路径的最佳实践
相对路径是相对于当前Markdown文件所在位置的路径。比如你的Markdown文件在/docs目录，图片放在/docs/images目录，那么引用图片时只需写./images/demo.png。这种方式的最大优势是：只要保持文件与图片的相对位置不变，在任何环境下都能正确加载。
我现在的项目都会建立这样的目录结构：
code复制project/
├── docs/
│ ├── images/ # 存放文档图片
│ ├── tutorial.md # 引用./images/xxx.png
│ └──