Markdown 文件怎么插入图片？

Markdown 是一种轻量级标记语言，广泛用于文档编写。插入图片是日常使用中的常见需求。本文将详细介绍如何在 .md 文件中正确添加图片。

1. 基本语法

Markdown 插入图片的语法如下：

![替代文字](图片路径)

• 替代文字（Alt Text）：当图片无法加载时显示的文字，也有助于 SEO 和无障碍访问。
• 图片路径：可以是本地路径或网络 URL。

2. 插入网络图片

直接使用图片的完整 URL 即可：

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

效果（假设图片存在）：

3. 插入本地图片

如果你在本地编写 Markdown 文件（如使用 Typora、VS Code 等），可以使用相对路径或绝对路径。

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

注意：本地图片在 GitHub、GitLab 等平台上需确保图片文件一同上传，并使用正确的相对路径。

4. 常见问题

• 图片不显示？ 检查路径是否正确，尤其是大小写和文件扩展名。
• 路径怎么写？ 推荐使用相对路径，例如 ![图](assets/logo.png) 表示当前目录下 assets 文件夹中的图片。
• 支持哪些格式？ 通常支持 .jpg、.png、.gif、.webp 等常见格式。

5. 小技巧

虽然标准 Markdown 不支持图片尺寸调整，但你可以在支持 HTML 的渲染器中使用 <img> 标签：

<img src="image.jpg" alt="自定义尺寸" width="300">