语法详解

Markdown 怎么插入图片:本地路径 / 图床 / 相对路径

图片语法其实就一行,难的是“为什么换了电脑就不显示了”。这篇把路径、图床和离线管理一次说清。

一、图片语法本身

Markdown 的图片就是“前面带 ! 的链接”,结构是 ![替代文字](图片地址 "可选标题"):

![一只猫](https://example.com/cat.png)
  • ! 表示这是图片,不是链接;
  • 方括号里是“替代文字”,图片加载失败或读屏时会读出来,对无障碍和 SEO 都有帮助;
  • 圆括号里是图片地址,可以是网址,也可以是本地文件路径;
  • 末尾引号里是鼠标悬停提示,可省略。

记法:把链接的语法记成 [文字](地址),前面加个 ! 就变成图片——文字变成了“替代文字”。

二、相对路径怎么写才稳

把图片和 .md 放在同一文件夹,用相对路径引用,是最适合离线、长期保存的写法:

./images/cat.png      # 当前目录下的 images 文件夹
../img/logo.png       # 上一级目录的 img 文件夹

相对路径的好处是:整个文件夹打包带走,换电脑、换盘符都不会断链。关键点是路径相对于“当前 Markdown 文件的位置”,而不是相对于你打开预览的网页根目录。

写法含义
cat.png和 md 同目录
./cat.png同上,显式写当前目录
images/cat.pngmd 下的 images 子目录
../cat.png上一级目录

三、图床与网络图片

如果你想把文档直接发到网上(博客、公众号、论坛),图片地址用网址最方便:

![封面](https://your-cdn.com/cover.jpg)

常见做法:把图片上传到对象存储 / 图床,拿到一个 HTTPS 链接填进去。优点是“一处上传、处处可显”;缺点是链接失效图片就没了,长期文档要选靠谱的服务,并保留本地备份。

四、离线写作如何管图片

纯本地写作时,推荐这样的目录结构,路径清晰又好迁移:

我的文档/
├─ 笔记.md
└─ 笔记.assets/
   ├─ cat.png
   └─ diagram.svg

在 笔记.md 里写 ![cat](笔记.assets/cat.png)。很多笔记软件(Obsidian、Typora)会自动采用这种“同名 .assets 文件夹”约定,拖图进文档就自动归位。

五、图片不显示的 5 个原因

1. 路径拼错或大小写不一致

Linux / 部署到服务器的环境区分大小写,Cat.png 和 cat.png 不是同一个文件。

2. 相对路径基准不对

预览器按“md 文件位置”解析相对路径;如果你用网页根目录去想,就会差一层。

3. 图床链接失效或被防盗链

部分图床禁止跨站引用,浏览器会拦截,换成允许外链的服务或自托管即可。

4. 少了 !

写成 [文字](图) 只会渲染成链接,不是图片——这是最常见的手滑。

5. 中文/空格路径未处理

路径含空格或中文时,给地址套上 %20 或用引号包裹更稳妥。

六、常见问题

Q:能不能调图片大小?
A:标准 Markdown 不支持尺寸参数。需要的话可用 HTML 的 <img src="..." width="300">,多数预览器都能渲染。

Q:基地址(base URL)能统一设置吗?
A:部分静态网站生成器支持配置 image_base_url,让相对路径自动拼上域名;纯手写 md 则直接写全网址最省事。

Q:在 365Lab 编辑器里怎么插图?
A:编辑器内容保存在本地,你可在支持 HTML 的场景用 <img>,或先把图片传到图床再用网址引用;需要批量管图时,本地相对路径 + 归档文件夹最稳。


图片之外,最常用的是表格和导出:看 Markdown 表格怎么写,或 怎么把 Markdown 转 PDF。

打开编辑器,试试图文混排

免注册、实时预览、内容本地保存。把图片语法和文字一起写进去,右侧立即出效果。

免费开始写作 →