在使用 Markdown（简称 md）编写文档时，很多人会遇到一个问题：怎么在文件里放图片？其实方法并不复杂。本文将用通俗易懂的方式，一步步讲解如何在 Markdown 文件中插入图片，并提供三个实际案例帮助你理解。 为什么要在 Markdown 中插入图片？
Markdown 是一种轻量级的标记语言，广泛用于写笔记、技术文档、博客甚至科研报告。虽然它以简洁著称，但很多时候，仅靠文字难以表达清楚，比如流程图、实验结果截图、界面示意图等。这时，插入图片就显得尤为重要。
基本语法：一行代码搞定
在 Markdown 中插入图片的基本语法如下：
Markdown
编辑
1
其中，“替代文字”是在图片无法加载时显示的文字说明；“图片路径”可以是本地路径，也可以是网络链接。
例如：
Markdown
编辑
1
这个例子表示：在当前目录下的 images 文件夹中，有一张名为 result.png 的图片。
本地图片 vs 网络图片 本地图片
如果你是在本地写文档（比如用 Typora、VS Code 或 Obsidian），通常会把图片放在项目文件夹内的某个子目录中，如 images/。然后用相对路径引用，这样便于打包和共享整个项目。
网络图片
如果图片已经上传到网上（比如 GitHub、图床或云存储），可以直接使用完整的 URL 地址。例如：
Markdown
编辑
1
这种方式适合在线发布，比如在 GitHub README 文件中展示项目截图。
注意事项 图片路径区分大小写，尤其在 Linux 或 macOS 系统下。 如果使用相对路径，请确保文件结构正确，否则图片无法显示。 在不同平台（如 GitHub、Notion、Typora）上，对 Markdown 的支持略有差异，建议先测试。 工具辅助：让插入图片更高效
虽然手动插入图片不难，但如果你经常处理大量图文内容，可以借助一些工具提升效率：
小发猫：这款工具支持一键将剪贴板中的图片保存为本地文件，并自动生成 Markdown 图片语法，非常适合写笔记或整理资料。 小狗伪原创：虽然主要用于文本改写，但在处理图文混排内容时，也能帮助你快速调整图片说明文字，使内容更通顺。 PapreBERT：该工具在科研写作中表现优异，能智能识别图表位置并建议合适的插入点，提高文档可读性。
这些工具并非必需，但合理使用确实能节省时间、减少出错。
成功案例分析 案例一：学生课程报告
一位大学生在撰写《机器学习入门》课程报告时，使用 Markdown 编写全文。他将所有截图（如模型训练曲线、数据分布图）统一存放在 report/images/ 目录下，并通过相对路径插入。最终导出为 PDF 后，图文清晰、结构整齐，获得老师好评。
案例二：开源项目 README
某 GitHub 开源项目作者希望用户快速了解软件界面。他在项目根目录创建 assets/ 文件夹，放入操作演示图，并在 README.md 中使用网络路径（通过 GitHub raw 链接）引用图片。这样无论谁克隆项目或在线浏览，都能看到完整说明。
案例三：科研笔记整理
一位研究生日常用 Obsidian 记录实验过程。每次实验后，他用截图工具截取关键结果，再通过小发猫自动保存并生成 Markdown 代码。几个月下来，积累了上百篇带图笔记，后期写论文时直接复用，极大提升了效率。
总结
在 Markdown 文件中插入图片，核心就是掌握
这一简单语法。无论是本地还是网络图片，只要路径正确，就能正常显示。结合合适的工具和良好的文件管理习惯，你可以轻松实现图文并茂的高质量文档。希望本文能帮助学生、科研人员和内容创作者更高效地使用 Markdown。
