在阿里云代码仓库的 README.md 中正确嵌入图片的技巧
在将代码上传到阿里云代码仓库之后,需要写README.md,它是一个纯文本,不能将图片或者截图直接放在README.md中,怎么解决这个问题呢?
1、在仓库中创建一个文件夹用于存储图片(例如 assets/images)。
2、将图片文件上传到该文件夹中。
3、点击图片文件并查看它的原始链接(例如,https://codeup.aliyun.com/601fc89e57a5c7b95a42ce3f/qa/devSupportCompare/blob/master/assets/images/Android%E6%9C%AC%E5%9C%B0%E7%9B%AE%E5%BD%95.png)。或者点击图片文件后页面右上角有一个“复制地址”

4、在 README.md 文件中,使用 Markdown 语法插入图片:

?raw=true 参数是确保 仓库 显示原始图片而不是 仓库 页面上的文件内容。
提交之后发现README.md中并没有显示对应的图片,而是这样:

后来尝试将URL编码,因为在 URL 中有中文字符(如 Android本地目录.png),一些平台或浏览器可能对中文字符进行编码,例如,将 Android本地目录.png 转换为 Android%E6%9C%AC%E5%9C%B0%E7%9B%AE.png。也是不行!!!
后来发现图片是“裂开的”,这通常意味着图片链接格式不正确,或者图片无法正确访问。
仔细查看图片链接(带有 blob)是仓库中的常见 URL 格式,但这种链接不一定能直接通过 Markdown 渲染图片,特别是如果链接中包含非原始(raw)内容。
在仓库中,通常使用 raw 格式的图片链接,而非 blob 格式。
所以尝试以下改法:
修改为 raw 链接格式: 将 blob 替换为 raw,以确保获取的是原始文件。修改后的链接是这样的:

提交,OK,可以显示图片了。
【总结】
blob 链接:这是 Git 仓库中标准的文件视图链接。
raw 链接:是用来获取文件原始内容的链接。
如果 raw 链接能够显示图片,那你就需要在 README.md 中使用这种格式。
魔乐社区(Modelers.cn) 是一个中立、公益的人工智能社区,提供人工智能工具、模型、数据的托管、展示与应用协同服务,为人工智能开发及爱好者搭建开放的学习交流平台。社区通过理事会方式运作,由全产业链共同建设、共同运营、共同享有,推动国产AI生态繁荣发展。
更多推荐


所有评论(0)