Showing results for 
Search instead for 
Did you mean: 
Sign up Log in
Deleted user
0 / 0 points
badges earned

Your Points Tracker
  • Global
  • Feed

Badge for your thoughts?

You're enrolled in our new beta rewards program. Join our group to get the inside scoop and share your feedback.

Join group
Give the gift of kudos
You have 0 kudos available to give
Who do you want to recognize?
Why do you want to recognize them?
Great job appreciating your peers!
Check back soon to give more kudos.

Past Kudos Given
No kudos given
You haven't given any kudos yet. Share the love above and you'll see it here.

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

What HTML does BitBucket support in their READMEs?

BitBucket's documentation says that they support a limited set of HTML tags for READMEs, but they never say what tags. I'm trying to embed an image using the <img> tag for control over image size, which Markdown doesn't support, but it shows up as the text for the HTML, ie. as <img src='mypicture.jpeg' width='100' height='100'> instead of the picture.

13 answers

1 accepted

0 votes
Answer accepted
Ana Retamal Atlassian Team May 22, 2017

Hi Paul! You can find more information about the HTML tags that can be used at Regarding images, you can jump directly to the section 6.6. 

Hope this helps :) 


Hi Ana,


Thank you for this information. It's unfortunate that BitBucket does not support <img> tags for sizing images. It's something I've grown accustomed to on GitHub and am dissapointed with the lack of formatting that BitBucket offers for documentation.



Like # people like this

It seems that Bitbucket Markdown does not support html-entities like &nbsp;, and literally displays it as &nbsp;, not as non-breaking space.

This is really awkward: I wrote a huge with hundreds of &nbsp;s, and in IntelliJ IDEA preview all works as expected. But on Bitbucket the layout displays as totally broken :(

Is there a plan/issue to fix this?

Like # people like this

I have the same issue as Dmitry for html entities in the readme file

Any Plans for this?

After importing a project from GitHub which has README documentation with loads of HTML in markdown, I can't view it properly here. It's a shame because I wanted to move out of GitHub. You should support html in markdown 👍

Not being able to size and/or float images is a PITA.

I'd really like to see this functionality added

No, Bitbucket Server displays an HTML hyperlink as code, even though the CommonMark spec says it is interpreted as HTML.

Any updates???

Markdown footnotes don't seem to work either in Atlassian's bitbucket ticketing system.


I am considering moving my repo over to Github from having to deal with this issue. It is unfortunate that re-sizing an image in a repo is not supported by Bitbucket. IMO, resizing an image is an essential & basic feature to include in a repo readme. I will explore other options, but have already wasted 20 minutes scouring the web for something that should be a simple add on. 

New question: Why doesn't bitbucket support html syntax in markdown snippets?

No delete answer?

Will this ever be fixed?

I always struggle with how bitbucket interprets markdown as well. My main concern is there is no way to check what it will look like other than actually push the changes. Not even consistent with how bitbucket displays markdown. Is there any other tool I can use?

The least bad solution I've settled on is a vscode extension hbrok.markdown-preview-bitbucket 

Note: now that there is an atlassian-maintained vscode integration: atlascode, maybe[?] something more official may be available one day. You could open an issue or make feature request i suppose

Simply infuriating...

Thank you for the links, will try it out. This should be fixed, it is always a guessing game with the bitbucket markdown.


Edit 1: The vscode plugin seems to show markdown correctly, unlike the bitbucket server once viewed online.

Yea this plugin is nice, but at the same time useless because bitbucket snippets do not follow this norm

Suggest an answer

Log in or Sign up to answer
Community showcase
Published in Bitbucket

Calling any interview participants for Bitbucket Data Center

Hi everyone,  We are looking to learn more about development teams’ workflows and pain points, especially around DevOps, integrations, administration, scale, security, and the related challeng...

505 views 6 4
Read article

Community Events

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

Find an event

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

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you