您可以使用

![A test image](image.png)

哪里[A test image]是您的alt文本，（image.png）是您图像的链接。

您可以将图像放在云服务或其他在线图像托管平台上或者，如果存储库中有图像链接，则可以从存储库中提供图像链接

您还可以在存储库中创建专用于自述文件图像的特定文件夹

您还可以像任何其他格式一样在markdown文件中插入动画SVG图像。它可以很好地替代GIF图像。

![image description](relative/path/in/repository/to/image.svg)
OR
<img src="relative/path/in/repository/to/image.svg" width="128"/>

示例（假设图像位于存储库中的assets目录中）：

![My animated logo](assets/my-logo.svg)

结果：

要使用基于GitHub深色/浅色主题的不同图像，请参阅本文。

您可以使用

![A test image](image.png)

哪里[A test image]是您的alt文本，（image.png）是您图像的链接。

您可以将图像放在云服务或其他在线图像托管平台上或者，如果存储库中有图像链接，则可以从存储库中提供图像链接

您还可以在存储库中创建专用于自述文件图像的特定文件夹

如果你不想用这些图片“搅乱”你的分支的内容，而且链接是绝对的对你来说也不是问题，那么我建议使用一个单独的孤立分支来存储这些图片。在这种情况下，图像将与回购集成，但不包含在主要内容中。此外，您可以对较大的文件使用LFS（所有主要的git主机都支持LFS）。

可以在命令行中轻松创建孤立分支：

git checkout --orphan images
git reset --hard
cp /path/to/your/image.jpg ./image.jpg
git add --all
git commit -m "Add some images"
git checkout master
git log -n 3 --all --graph

如果一切正常，请推送新分支：

git push -u origin images

然后使用图像的原始github URL。

您可以使用替代的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（此处）中使用项目中的图像

现在，您可以在编辑自述文件时拖放图像。

Github将为您创建一个链接，其格式为：

https://user-images.githubusercontent.com/******/********.file_format

或者，在文件的底部，它会显示“通过拖放、选择或粘贴来附加文件”。如果你点击那个，它会给你一个直接上传文件的选项，或者你可以直接粘贴它！