Markdown文件怎么添加图片？

在编写 Markdown（.md）文档时，插入图片是常见的需求。本文将详细介绍如何在 Markdown 文件中正确添加本地或网络图片。

1. 基本语法

Markdown 插入图片的语法如下：

![替代文本](图片地址 "可选标题")

• 替代文本：当图片无法显示时，会显示该文字。
• 图片地址：可以是本地相对路径、绝对路径，或网络 URL。
• 可选标题：鼠标悬停在图片上时显示的提示文字（可省略）。

2. 插入网络图片

直接使用图片的网络链接即可：

![示例图片](https://example.com/image.jpg)

3. 插入本地图片

确保图片与 .md 文件在同一目录或子目录下，使用相对路径：

![本地图片](./images/photo.png)

注意：部分编辑器（如 VS Code）支持预览本地图片，但 GitHub 等平台要求图片必须上传到仓库中。

4. 常见问题

1. 图片不显示？ 检查路径是否正确，注意大小写和空格。
2. GitHub 上图片失效？ 请勿使用本地路径，应将图片上传至仓库或图床。
3. 想控制图片大小？ 标准 Markdown 不支持，但部分平台（如 Typora、Obsidian）支持 HTML 写法：
   <img src="image.jpg" width="300" />

5. 小贴士

• 推荐将所有图片放在 assets/ 或 images/ 文件夹中，便于管理。
• 使用有意义的文件名，如 workflow-diagram.png 而非 IMG_1234.png。