在 BitBucket 上将图像添加到 README.md

Add images to README.md on BitBucket

我能否以某种方式引用 readme.md 文件中的图像,以便它在 BitBucket 中直接从项目中查看时呈现(无需在网络上的其他地方托管图像)?

更新:

issue 已解决,因此它现在可以正常工作,如问题中所述:

我已将 readme.md 文件和图像文件存储在 BitBucket 存储库中,如下所示:

我参考了readme.md的图片如下:

![Scheme](images/scheme.jpg)

2016-12-14更新

此问题现已修复,请查看此问题的 resolved 状态:https://bitbucket.org/site/master/issues/6315/relative-urls-in-readmemd-files-only-work

您现在可以使用

![Scheme](images/scheme.jpg)

使用相关链接引用您存储库中的图像。

旧答案

目前,这是不可能的。 BitBucket 不支持 Markdown 中图片的相对链接。

BitBucket 问题跟踪器中的以下问题有更多相关信息,其当前状态 (2015-02-27) 为 openhttps://bitbucket.org/site/master/issue/6315/relative-urls-in-readmemd-files-only-work

BitBucket 团队已在票证上表明他们打算解决此问题 "in the coming quarters"(来自 2014-12-19 的评论:https://bitbucket.org/site/master/issue/6315/relative-urls-in-readmemd-files-only-work#comment-14400835)。

该票证包含一些(丑陋的)解决方法,使用两个链接的组合,一个在本地工作,一个在网站上工作 (https://bitbucket.org/site/master/issue/6315/relative-urls-in-readmemd-files-only-work#comment-15852315) 以及其他一些可能的解决方案,none 其中特别好或可靠。

更新:请查看已接受的答案,因为问题现已解决,此解决方法已过时。


根据 Altassian,它不受支持,因此您需要使用绝对 URL。如果您在以后的提交中更改图像,您可以使用分支名称而不是提交哈希来允许更新 link。

例如,这里是 /path/to/image.jpg,来自 master 分支:

[Your Link Text](https://bitbucket.org/username/reponame/raw/master/path/to/image.jpg)

Don't use any spaces in image or directory names. For example: ![](images/app screens/screen 10.png) should become Sub-folders can be used for other md documents. Again, I recommend replacing spacing with dashed even in folders that only contain md or other files.

Not sure about this, but the starting document might need to be named README.md, and images might need to be in a top-level folder named "images" in the same directory as the README.md file.

Finally, please refresh your page when you see a broken image link. I noticed some images would load and others were not even though they were in the same format.

更多信息,请查看Atlassian: Add images to a wiki page and russells-rocksauce answer in bitbucket issues forum

很简单

只需将您的图像上传到存储库根目录,然后 link 不带任何路径的文件名,如下所示:

![your_image_name](your_image_name.png)