Markdown 添加本地图片完整指南

在使用 Markdown 编写文档时，插入本地图片是常见需求。本文将详细介绍如何在 Markdown 中正确引用本地图片，并提供实用技巧与注意事项。

1. 基本语法

Markdown 使用以下语法插入图片：

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

其中：

• 替代文本（Alt Text）：当图片无法显示时的提示文字，对 SEO 和无障碍访问很重要。
• 图片路径：可以是相对路径或绝对路径。

2. 使用相对路径

推荐使用相对路径，便于文档迁移。例如：

![示例图](./images/example.png)

假设你的 Markdown 文件和 images 文件夹在同一目录下。

3. 注意事项

• 确保图片文件存在且路径正确。
• 路径区分大小写（尤其在 Linux/macOS 系统中）。
• 部分编辑器（如 VS Code）需安装预览插件才能显示本地图片。
• 导出为 HTML 或 PDF 时，注意是否自动嵌入或复制图片资源。

4. 常见问题

Q：图片不显示怎么办？
A：检查路径是否正确，建议使用相对路径，并确认文件名无中文或特殊字符。

Q：能否调整图片大小？
A：标准 Markdown 不支持，但部分解析器（如 Typora）支持 HTML 语法：

<img src="image.png" width="300" />