我需要在README文件中包含一些图像。我不知道该怎么做这样做。

我创建了一个小向导，允许您为GitHub存储库的自述文件创建和自定义简单的图像库：请参阅ReadmeGalleryCreatorForGitHub。

该向导利用了GitHub允许img标签出现在README.md中的事实。此外，该向导还利用了将图像上传到GitHub的流行技巧，方法是将图像拖放到问题区域（如本主题的一个答案中所述）。

有两种简单的方法可以做到这一点，

1） 使用HTML img标记，

2) ![]（保存图像的路径/image-name.png）

打开图像时，可以从浏览器中的URL复制路径。可能会出现间距问题，因此请确保在路径或图像名称add->%20中是否有空格b/w两个字。就像浏览器一样。

如果你想了解更多，可以查看我的github->https://github.com/adityarawat29

您可以使用替代的github CDN链接从README.md（或外部）链接到项目中的图像。

URL将如下所示：

https://cdn.rawgit.com/<USER>/<REPO>/<BRANCH>/<PATH>/<TO>/<FILE>

我的项目中有一个SVG图像，当我在Python项目文档中引用它时，它不会呈现。

项目链接

以下是文件的项目链接（不渲染为图像）：

https://github.com/jongracecox/anybadge/blob/master/examples/awesomeness.svg

嵌入图像示例：

原始链接

以下是指向文件的RAW链接（仍然无法渲染为图像）：

https://raw.githubusercontent.com/jongracecox/anybadge/master/examples/awesomeness.svg

嵌入图像示例：

CDN链接

使用CDN链接，我可以使用（渲染为图像）链接到文件：

https://cdn.rawgit.com/jongracecox/anybadge/master/examples/awesomeness.svg

嵌入图像示例：

这就是我如何在README.md文件和PyPi项目reStructedText doucmentation（此处）中使用项目中的图像

在我的例子中，我使用imgur并以这种方式使用直接链接。

![img](http://i.imgur.com/yourfilename.png)

你可以这样做：

git checkout --orphan assets
cp /where/image/currently/located/on/machine/diagram.png .
git add .
git commit -m 'Added diagram'
git push -u origin assets

然后，您可以在README文件中引用它，如下所示：

![diagram]（diagram.png）

这就行了！！

注意标记中的文件名大写，将PNG文件放入根目录，并链接到没有任何路径的文件名：

![Screenshot](screenshot.png)