Markdown在GitHub存储库上插入并显示图像

41

根据GitHub文档，用于插入图像的Markdown语法为：

![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)

按照他们的示例语法，我似乎无法使其工作。

甚至GitHub徽标示例也不起作用。

我想念什么？还是GitHub错误？

github markdown

— 尼克
source

将URL更改为带有HTTP的完整路径，然后查看将您带到何处

— 八日的灾难2012年

@EightDaysofMalaise：确实可以解决这个问题……请您写下来作为答案？我向Github报告了文档错误。

— nic 2012年

我认为他们的文档已更改。页面上不再提及“图像”，“图片”和“徽标”。

— jww 2015年

35

您可能会缺少要包含在Markdown文件中的图像的完整路径/位置。

给出的示例是一个相对路径，其中图像与文件位于同一服务器上。在帮助中，它将假定图像实际位于：

https://github.com/images/logo.png

但这不是有效的文件或位置。

为了确保无论您在哪里查看都可以渲染图像，包含完整URL（包括域名）是更安全的。

因此，您的示例将改为使用与此类似的内容：

![Bilby Stampede](http://example.com/images/logo.png)

— 八日病
source

25

针对以上答案：

从2013年1月30日起，GitHub现在允许相对链接。

不过，请确保在URL末尾附加？raw = true。这是一个例子：

![Image](../blob/master/public_html/img/nokia.png?raw=true)

由于GitHub处理URL的方式，如果不将？raw = true附加到源URL，浏览器将尝试加载显示图像的页面。

— 克里斯·莫里斯
source

您确定该更新还包括用作src吗？

— 马拉加八日（2013年

1

是的，它确实。但是，您必须在URL末尾附加“？raw = true”。这是一个示例： ！[Image]（../ blob / master / public_html / img / nokia.png？raw = true）

— 克里斯·莫里斯

刚刚更新了答案:)。

— 克里斯·莫里斯

1

这适用于我的Markdown文件，但pandoc出现错误：pandoc：从TeX源生成PDF时出错。！LaTeX错误：未知图形扩展名：.png？raw = true。有关说明，请参阅LaTeX手册或LaTeX Companion。键入H <return>以立即获得帮助。... l.175 ... 2014-04-08_Bergman2011_Fig2.png？raw = true}

— djhocking 2014年

2

我喜欢在本地进行Markdown测试，然后再将其推送到只能通过URL进行查看的地方。所以我想要一个可以在任何地方使用的相对URL。GitHub现在支持这些。

您的images子目录，假设它是在相同的目录中的文件降价，一开始并不需要一个斜杠-尝试：

markdown ![GitHub Logo](images/logo.png)

代替

markdown ![GitHub Logo](/images/logo.png)

— 麸皮
source