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

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


按照其示例语法,我似乎无法使其工作。

即使GitHub徽标示例也不起作用。

我缺少什么?还是GitHub错误?

评论

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

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

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

#1 楼

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

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

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


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

在为了确保无论您从何处查看图像都可以渲染图像,包含完整的URL(包括域名)会更安全。

因此,您的示例将改用某些内容与此类似:

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


#2 楼

针对上述回答:

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

请确保在末尾附加?raw = true。网址,不过。这是一个示例:

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


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

评论


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

–八日病
13年1月31日在21:48

是的,它确实。但是,您必须在URL末尾附加“?raw = true”。这是一个示例:![Image](../ blob / master / public_html / img / nokia.png?raw = true)

–克里斯·莫里斯(Chris Morris)
13年2月1日在6:29



刚刚更新了答案:)。

–克里斯·莫里斯(Chris Morris)
13年2月1日在6:32

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

– djhocking
2014年4月8日20:55



#3 楼

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

您的images子目录,假设它与Markdown文件位于同一目录中,开始时不需要斜杠—试试:

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

而不是

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