基本语法

![myimage-alt-tag](url-to-image)

在这里：

my image alt标记：如果未显示图像，将显示的文本。图像的url：无论您的图像资源是什么。图像的URI

例子：

![stack Overflow](http://lmsotfy.com/so.png)

如下所示：

我通常在网站上托管图像，这可以链接到任何托管图像。把这个放在自述文件里。适用于.rst文件，不确定.md

.. image:: https://url/path/to/image
   :height: 100px
   :width: 200 px
   :scale: 50 %

尝试此标记：

![alt text](http://url/to/img.png)

我认为，如果图像存储在存储库中，您可以直接链接到原始版本的图像。即

![alt text](https://github.com/[username]/[reponame]/blob/[branch]/image.jpg?raw=true)

您可以使用替代的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存储库中。

然后：

在浏览器上打开相应的Github repo。导航到目标图像文件，然后在新选项卡中打开图像。复制url最后将url插入到以下模式！[替换文本](https://raw.githubusercontent.com/username/projectname/branch/path/to/img.png)

就我的情况而言


哪里

shadmazumder是我的用户名Xcode是项目名称master是分支InOnePicture.png是图像，在我的情况下，InOnePicture.php位于根目录中。

创建有关添加图像的问题通过拖放或文件选择器添加图像然后复制图像源现在添加！[替换标签](http://url/to/img.png)到README.md文件

完成！

或者，您可以使用imgur之类的图像托管站点，获取其url并将其添加到README.md文件中，或者也可以使用一些静态文件托管。

样品问题