如何在GitHub中添加图片？

[bigbeats]

想要把自己整理的知识点展示的更加清晰和易于让其他同学理解，添加图片是很有必要的。那么如何能在GitHub的文档中显示出图片呢？

[bigbeats]

step1 首先我需要在本地目录中添加一张图片，考虑到大家以后可能会经常使用图片，所以建立了一个名为images-folder的文件夹，并统一把图片放到这个文件夹里。
step2 将本地目录的修改push到自己的仓库。
step3 此时要引用的图片已经放在仓库的文件夹images-folder里面
step4 现在，我要在当前md文件里链接这张图片，我必须知道github 图片链接格式，即 ，即 叹号!+方括号[ ]+圆括号( ) 其中圆括号里是图片的URL，方括号里可以不填。
step5 来看看例子吧(大家记得在给文件命名时必须加上 .md 否则打开文件不能看到图片)
例子详见Linked pull requests或者下方链接：
https://github.com/opensource-team/Git-Github-notes-for-study/blob/master/%E2%80%9C%E6%B7%BB%E5%8A%A0%E5%9B%BE%E7%89%87%E2%80%9D%E6%96%B9%E6%B3%95.md

[frank-zsy]

我补充几点：
1、Markdown 作为一种标记语法，其最终需要渲染器渲染成为对应的视觉效果，而目前常见的渲染一般都是渲染成为 HTML，或即使在 VSCode 等 IDE 中的渲染工具也是兼容 HTML 标签的。
2、所以需要注意一下 Markdown 渲染机制，例如 GitHub 使用自己的一套渲染标准，可以参考 GitHub Flavored Markdown Spec。
3、一般而言，在 Markdown 中使用 ![]() 语法注入的图片都会被渲染成 HTML 的 img 标签，也就是静态图片标签。
4、所以如果是 jpg、png 等静态图片，可以用这种方式注入，但例如 svg 的动态图片，则会出现渲染异常，需要考虑直接使用 HTML 的 embed 标签注入。
5、git 仓库 clone 时都是全量同步的，不支持类似 SVN 的目录级控制，所以一般不建议直接把静态图片资源放在 git 仓库中，这会导致仓库巨大，拉取困难。可以考虑自己搭建图床服务，或使用第三方的 CDN 服务（例如七牛等）进行静态图片资源的托管。

[bigbeats]

十分感谢老师的补充！感觉知识点很多，我们需要补习一下！感谢您！