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

时间:2015-02-27 13:44:46

标签: image git markdown bitbucket

我可以以某种方式引用readme.md文件中的图像,以便在项目中直接在 BitBucket 中查看时呈现(不在网络上的其他位置托管图像)吗?

更新

issue已经解决,因此现在正如问题中所解释的那样:

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

  • readme.md
  • 图像/
    • scheme.jpg

我从readme.md引用图片如下:

![Scheme](images/scheme.jpg)

4 个答案:

答案 0 :(得分:38)

更新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)打开https://bitbucket.org/site/master/issue/6315/relative-urls-in-readmemd-files-only-work

BitBucket团队已在机票上注明他们打算在未来几个季度解决这个问题(评论来自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)以及一些其他可能的解决方案,其中没有一个特别好或可靠。

答案 1 :(得分:14)

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


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

例如,这里是/path/to/image.jpg分支中的master

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

答案 2 :(得分:1)

  

不要在图片或目录名称中使用任何空格。例如:   ![](images / app screens / screen 10.png)   应该成为      子文件夹可用于其他md文档。同样,我建议甚至在仅包含md或其他文件的文件夹中用虚线替换间距。

     

不确定这一点,但起始文档可能需要命名为README.md,图像可能需要位于名为"图像"的顶级文件夹中。在与README.md文件相同的目录中。

     

最后,当您看到损坏的图片链接时,请刷新您的页面。我注意到有些图像会加载,而其他图像则不是相同的格式。

如需了解更多信息,请查看Atlassian: Add images to a wiki pagerussells-rocksauce answer in bitbucket issues forum

答案 3 :(得分:0)

这很简单

只需将您的图像上传到存储库根目录,然后链接到没有任何路径的文件名,就像这样:

![your_image_name](your_image_name.png)