Spring Boot项目中README.md如何智能引用resources文件夹图片？

正确的相对路径写法 #

你的README.md位于项目根目录，直接从根目录出发指向resources里的图片即可，无需特殊符号：

### Diagram

<!-- HTML 写法 -->
<img src="src/main/resources/images/entity-diagram.png" width="600"/>

<!-- 或 Markdown 原生图片语法 -->
![实体关系图](src/main/resources/images/entity-diagram.png){: width="600"}

为什么~\images\entity-diagram.png失效？ #

Markdown不支持~作为用户目录的简写，它的相对路径是严格基于当前文件所在位置（项目根目录）解析的，必须逐层指定完整的相对路径。

优化建议 #

如果想让结构更清晰，建议把文档用的图片移到项目根目录下的独立文件夹（比如docs/images或直接images），这样路径会更简洁：

### Diagram

![实体关系图](images/entity-diagram.png){: width="600"}

这种方式不管是本地预览还是托管到GitHub/GitLab等平台，都能正常显示图片。

内容的提问来源于stack exchange，提问作者Jack