在BitBucket的README.md中添加图片

Question

我能否以某种方式从readme.md文件中引用图像，使其在项目中直接从 BitBucket 查看（而无需在 Web 上托管图像）？

更新：

问题已解决，因此现在可以按照以下方式工作：

我将readme.md文件和一个图像文件存储在 BitBucket 仓库中，如下所示：

• readme.md
• images/
  • scheme.jpg

我通过以下方式引用来自readme.md的图像：

！[Scheme]（images / scheme.jpg）

- Danny Dan

---

你指的是哪个教程？请编辑你的问题并添加链接。 - jub0bs

Answer 1

更新 2016-12-14

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

您现在可以使用

![Scheme](images/scheme.jpg)

目前不支持使用相对链接引用Markdown中的图像。BitBucket的问题跟踪器中有关于此问题的更多信息，其当前状态（2015-02-27）为“open”：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)，以及其他一些可能的解决方案，但都不是特别好或可靠。

- nwinkler

---

是的，现在已经修复了。 - joan

适用于我。顺便说一下：如果图像与自述文件位于同一根目录级别，则相对路径仅包含图像名称，这对我没有起作用。一旦我创建了一个文件夹并将图像放在其中，就像上面那样做，它就可以工作了。 - VinjaNinja

注意：如果您在预览窗口上编辑md文件，则不会显示图像。 您需要提交更改并清除缓存。 - Eric Wu

我也不行。 - Jason

Answer 2

更新：请查看已被接受的答案，问题已得到解决，这个解决方法已经过时。

---

根据 Altassian 的说法，Markdown 不支持相对链接，因此您需要使用绝对URL。您可以使用分支名称而不是提交哈希来允许在以后的提交中更改图像时更新链接。

例如，这里从 master 分支获取 /path/to/image.jpg：

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

- Sébastien Dawans

---

https://bitbucket.org/<user-name>/<repo-name>/raw/<branch-name>/<path> - Benny

这个可以工作。重要的部分是在路径中使用 raw 使其正常工作。 - andude

@Benny：感谢您的评论，我已点赞因为它对我有帮助。但是填写您评论中的空白字段只适用于主分支（请注意，我尚未在主分支上有该图像）。我认为最安全的方法是将图像作为原始文件打开，然后复制地址栏中显示的链接。在我的情况下，“<branch-name>/<path>”（参考您的答案）必须替换为“<image_name>.PNG?at=refs%2Fheads%2Fdevelopment”（此处没有反斜杠）。 - mgross

@nwinkler的更新答案现在可用，这个答案只有当图片在主分支中时才有效。 - SRi

Answer 3

不要在图像或目录名称中使用任何空格。例如：  应更改为

可以使用子文件夹用于其他md文档。同样，我建议即使是仅包含md或其他文件的文件夹也要用破折号替换空格。

不确定，但起始文档可能需要命名为README.md，并且图像可能需要位于名为“images”的顶级文件夹中，该文件夹与README.md文件位于同一目录中。

最后，请在看到损坏的图像链接时刷新页面。我注意到有些图像会加载，而其他图像则没有，即使它们的格式相同。

有关更多信息，请查看Atlassian: Add images to a wiki page和russells-rocksauce answer in bitbucket issues forum。

- GG86

---

是的，但我发现上面的链接更好且更新。事实上，Bitbucket没有像之前回答中描述的图片绝对URL的相同限制。 - GG86

Answer 4

这很简单

只需将您的图像上传到存储库根目录，并链接到文件名，不需要任何路径，就像这样：

![your_image_name](your_image_name.png)

- Srikrushna