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.

3 answers

1 accepted

0 votes
Accepted answer

Hi Paul! You can find more information about the HTML tags that can be used at http://spec.commonmark.org/0.21/#html-tag. 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 1 person likes 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 Readme.md 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 1 person likes this
venomDev I'm New Here Aug 28, 2018

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

0 votes

No delete answer?

0 votes

Any Plans for this?

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 ...

690 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