最近我加入了GitHub。我在那里主持了一些项目。

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

我搜索了一下,但得到的只是一些链接,告诉我“在web上托管图像并在README.md文件中指定图像路径”。

是否有任何方法可以在不在任何第三方网络托管服务上托管图像的情况下做到这一点?


当前回答

用桌子突出,这会给它带来独特的魅力

表语法为:

按符号分隔每个列单元格|

表格标题(第一行)由第二行由---

|第1列|第2列||------------|-------------||图像1 |图像2|

输出

现在,如果使用两个图像,只需在图像1和图像2处放置<img src=“url/relativePath”>

注意:如果使用多个图像只是包含更多列,则可以使用width和height属性使其看起来可读。

实例

|第1列|第2列||------------|-------------||<img src=“https://media.wired.com/photos/5926db217034dc5f91becd6b/master/w_582,c_limit/so-go-s.jpg“width=”250“>|<img src=”https://mk0jobadderjftub56m0.kinstacdn.com/wp-content/uploads/stackoverflow.com-300.jpg“width=”250“>|

间距无关紧要

输出图像

帮助人:adam-p

其他回答

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

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

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

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

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

您可以创建新问题上传(拖放)图像到它复制图像URL并将其粘贴到README.md文件中。

下面是一个详细的youTube视频,详细解释了这一点:

https://www.youtube.com/watch?v=nvPOUdz5PL4

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

您还可以像任何其他格式一样在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深色/浅色主题的不同图像,请参阅本文。