Danny Dan Danny Dan - 3 months ago 88
Git Question

Reference an image in BitBucket readme.md

I have stored

file and an image file in a BitBucket repo as follows:

  • readme.md

  • images/

    • scheme.jpg

I reference the image from
as follows:


Can I somehow reference the image from readme file so that it renders when viewed in BitBucket? In tutorial there is only http link way.

P.S. The issue was resolved so it's working now as explained in the question.


At the moment, this is not possible. BitBucket does not support relative links to images in markdown.

The following issue in BitBucket's issue tracker has more info on this, its current status (2015-02-27) is open: https://bitbucket.org/site/master/issue/6315/relative-urls-in-readmemd-files-only-work

The BitBucket team have indicated on the ticket that they intend to fix this "in the coming quarters" (comment from 2014-12-19: https://bitbucket.org/site/master/issue/6315/relative-urls-in-readmemd-files-only-work#comment-14400835).

The ticket contains a couple of (ugly) workarounds, using a combination of two links, where one works locally, and one on the web site (https://bitbucket.org/site/master/issue/6315/relative-urls-in-readmemd-files-only-work#comment-15852315) as well as some other possible solutions, none of which are particularly nice or reliable.