在使用 Markdown 编写文档时,很多人会遇到一个问题:如何把本地的图片插入到文档里?尤其是在写实验报告、课程笔记或科研初稿时,图文并茂能让内容更清晰易懂。本文将用通俗易懂的方式,介绍在 Markdown 中添加本地图片的方法,并结合三个实际案例说明其应用。 什么是 Markdown?
Markdown 是一种轻量级的标记语言,广泛用于写博客、做笔记、撰写技术文档等。它语法简单,只需几个符号就能实现格式排版。但和 Word 不同,Markdown 本身不直接“嵌入”图片,而是通过路径引用图片文件。
插入本地图片的基本语法
在 Markdown 中插入本地图片,使用如下语法:
Markdown
编辑
1
替代文字(Alt text):当图片无法显示时,会显示这段文字,对可访问性和 SEO 有帮助。
图片路径:可以是相对路径,也可以是绝对路径。通常建议使用相对路径,这样文档在不同电脑上也能正常显示图片。
例如,如果你的 Markdown 文件和图片都在同一个文件夹下,图片名为 figure1.png,那么写法就是:
Markdown
编辑
1
如果图片放在子文件夹 images/ 里,则写成:
Markdown
编辑
1
注意事项
路径区分大小写:在 macOS 和 Linux 系统中,文件名大小写敏感,务必确保路径拼写完全正确。
支持的图片格式:常见的如 .png、.jpg、.jpeg、.gif 都可以。
预览环境要支持:有些纯文本编辑器(如记事本)无法显示图片,建议使用支持 Markdown 预览的工具,比如 Typora、VS Code(配合插件)、Obsidian 等。
案例一:学生写课程实验报告
小李是一名大二物理系学生,他需要提交一份关于“光的干涉”实验的报告。他用 Markdown 写正文,并用手机拍下实验装置照片,保存为 setup.jpg。他将图片和 .md 文件放在同一目录下,插入代码:
Markdown
编辑
1
老师用支持 Markdown 的阅读器打开后,图片正常显示,报告结构清晰,获得了高分。
案例二:研究生整理文献笔记
研究生小王在阅读一篇论文时,想把其中的关键图表截图保存下来,并在自己的笔记中标注出处。他建立了一个 notes/ 文件夹,里面包含 paper_summary.md 和 figures/ 子文件夹。他在 Markdown 中这样引用:
Markdown
编辑
1
这种方式让他在日后复习时能快速定位图表,也方便用“小发猫”等工具进行知识整理和语义检索。
案例三:科研团队共享初步结果
一个科研小组正在合作撰写项目中期报告。成员 A 用 Python 生成了数据可视化图,保存为 results_plot.png,并上传到共享文件夹。其他成员在各自的 Markdown 文档中通过相对路径引用该图:
Markdown
编辑
1
整个团队无需依赖复杂排版软件,仅用纯文本和图片就完成了高效协作。在需要润色或改写初稿时,他们偶尔会借助“小狗伪原创”调整语句表达,再用“PapreBERT”检查逻辑连贯性,确保内容准确无误。
小结
在 Markdown 中插入本地图片并不难,关键在于理解路径的写法和使用合适的预览工具。对于学生、科研人员等经常需要记录、分享图文信息的人群来说,掌握这一技能能极大提升写作效率和文档可读性。只要注意文件组织结构,保持路径清晰,就能轻松实现图文混排,让知识表达更直观、更专业。