如何在MD文件中添加图片

Markdown图片插入详细教程与实用技巧

什么是Markdown图片语法？

Markdown是一种轻量级标记语言，使用简单的符号来格式化文本。添加图片是Markdown中最常用的功能之一，它使用特定的语法来引用和显示图像。

Markdown图片语法基于HTML的<img>标签，但更加简洁易用。

在Markdown中添加图片的基本语法如下：

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

其中：

![三国地图](https://example.com/sanguo-map.jpg "中国三国时期地图")

这将显示一张带有替代文本"三国地图"和标题提示"中国三国时期地图"的图片。

最简单的方式是引用网络上的图片链接：

![GitHub Logo](https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png)

确保图片URL是公开可访问的，否则用户可能无法看到图片。

提示：推荐使用可靠的图床服务（如GitHub、Imgur等）来托管您的图片，确保长期可访问性。

您也可以引用项目中的本地图片文件。这通常用于文档项目、博客或笔记系统。

使用相对于.md文件位置的路径：

![项目架构图](./images/architecture.png)
![流程图](../assets/diagram.jpg)
![图标](icon.png)

典型的项目结构可能如下：

project/
├── docs/
│   └── tutorial.md
├── images/
│   ├── logo.png
│   └── screenshot.jpg
└── README.md

在tutorial.md中引用logo.png：

![项目Logo](../images/logo.png)

标准Markdown不支持直接设置图片尺寸，但许多平台（如GitHub）支持HTML语法：

<img src="image.jpg" alt="描述" width="300" height="200">

同样可以使用HTML实现对齐：

<div align="center">
  ![](image.jpg)
</div>

专业建议：对于重要项目，建议创建专门的assets或images目录来集中管理所有图片资源。