能否用Markdown在GitHub工作流步骤摘要中显示仓库本地图片？
2026-6-21
GitHub工作流步骤摘要能否显示图片？
可以显示，但不能用本地相对路径引用图片。
你遇到的情况是因为工作流步骤摘要的内容在GitHub服务器端生成后，会在GitHub前端页面渲染，本地路径（比如./process/assets/inactive.png）指向的是工作流运行容器内的文件，GitHub前端无法访问这些本地资源，所以只会显示替代文本，并且自动将文本转为链接（但该链接在前端环境中无效）。
正确的做法是使用可公开访问的绝对URL引用图片，比如：
- 仓库文件的raw地址：
 - GitHub Pages托管的图片地址
- 其他公开CDN的图片地址
虽然官方说明步骤摘要支持GitHub Flavored Markdown，但图片引用遵循GMD通用规则——必须指向能被浏览器直接加载的公开资源，本地相对路径不符合这一要求。
内容的提问来源于stack exchange，提问作者Peter Hornsby
相关产品推荐
相关产品推荐
