How to add images to Readme.md

Hello,

I am trying to add some images to my Readme.md file as

 

![picture](http://stash.xxxxxx.com/projects/zzzzz/img/abc.png)

 

but its not working. when i view the readme, all i see is the plain text

 

![picture](http://stash.xxxxxx.com/projects/zzzzz/img/abc.png)

please help

5 answers

1 accepted

5 votes
Accepted answer

Hi,

You can include an image by specifying the path relative to your repository root directory:

![picture](img/abc.png)

Hope this helps.

Cheers,

Michael

 

thanks michael but i still get the plaintext ![picture](img/stormConsole.png) also, i cant seem to be able to escape quotes. i tried using \' but this shows up as \' does stash render markdowns differently ?

I've just checked it again: ![Alt text](path/to/your/img.png) works as intended. Do you have it on a separate line?

No, it doesn't show image in README on project page. I've tryied both relative links and absolute path to dropbox hosted image (http://*.png) - doesn't work... This is sad. 

Ilya, I was having same problem. If I removed all space in front of the tag, my image started showing up. Apparently, you can't indent.

![alt text](images/successful.png)

This worked for me.

I had the same problem and tried a lot (relative path, upper/lowercase etc.).

What solved it finally was adding the alternative text.

As Michael said, this is a valid format working locally in editor preview and remote on Stash/Bitbucket:

![alternativetext](subfolder/image.png)

 

Dear all,

Same problem since new version of bitbucket.

Last week, no issue to display the picture.

Now, the issue is the picture is not displayed.

To get back the picture, we need :

- Edit the readme.md file

- press CANCEL

Then the picture is displayed again.

 

 Capture.PNG

the path is : ![home](images/home.png)

Thanks if anybody could highlight me about this.

 

Best regards,

Youssef

Changing my comment to STILL NOT WORKING.

It still will not render correctly on the overview page.

Dear

 

Yest it is.

Without :

- Edit the readme.md file

- press CANCEL

No pictures.

 

Best Regards,

Youssef

This does not work as intended. Maybe it's working in existing README's but not new ones.

I added an image to my repo in a folder. I added the markdown

![Screenshot](examples/screenshot.png)

When I view my readme on bitbucket I get a broken image link. I opened the inspector and the path/image are correct! The file is requested and returns a 200. Except that the content type is text/html :(

It appears that the markdown parser is interpreting the code incorrectly.

@Boujraf Youssef Your fix works temporarily. On reloading the page, the images get lost again.

same problem here, it was working but with the new design the images disappeared...

Same problem here

Anyone work this out yet?

I'm having the same issue. It does work if I go to the Readme file, push Edit, then push Cancel. Otherwise, it's just showing the alt-text and a broken image icon. I mean, if nothing else, can the broken image icon go away and the alt text just behave like it normally would on a website?

It does work, but the problem is it only works in the master branch. If you have a feature branch and try to test it out, it will appear as a broken link. When you merge to the master, your image will show up. Atlassian should fix this.

Like 1 person likes this

Not only does it only work in the master branch, the image still won't display.  You  have to actually click on the alternate text (which is hyperlinked) to the image file, which then displays properly in a new window.

EDIT:  I had an extra [] pair around the alt-text; weird behavior for sure... 

But still only works with master.

Get the full path by navigating to your image file, push 'raw file'-button right of the page, copy the path except for the very end (e.g. image.png?at=refs%2Fheads%2Fmaster). In general the path should be https://......../[project_name]/raw/[image_folder]/[image.png]

This works.

This works only in preview mode (while editing the README.md file inside the bitbucket itself)

     

0 votes

This worked for me. I used the absolute path suggested by @Mikko Salonen along with the following format:

.. figure:: https://absolute/path/to/image.png
   :alt: alias of image
0 votes

How does Atlassian even dare to claim projects are migrating from GitHub into here if it does not support such simple feature...

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Nov 06, 2018 in Bitbucket

Upgrade Best Practices

Hello! My name is Mark Askew and I am a Premier Support Engineer for products Bitbucket Server/Data Center, Fisheye & Crucible. Today, I want to bring the discussion that Jennifer, Matt, and ...

655 views 5 9
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you