What HTML does BitBucket support in their READMEs?

mojaveazure May 19, 2017

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.

15 answers

1 accepted

0 votes
Answer accepted
Ana Retamal
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
May 22, 2017

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 :) 

Ana

mojaveazure May 23, 2017

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.

 

Paul

Like # people like this
dmitry-popov August 6, 2018

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 # people like this
venomDev August 28, 2018

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

Like Erik Van Till likes this
6 votes
Niraj Khanal October 10, 2018

Any Plans for this?

4 votes
bulbazaur bulbazaur March 19, 2020

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 👍

3 votes
Robert Peschke July 20, 2020

^bump.

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. 

3 votes
Jonathan Pool November 2, 2019

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

1 vote
Mohammad Zekrallah December 13, 2021

bitbucket is becoming more of an obsolete, outdated and dinasour of a system.. we're definitely moving .. something as stupid and simple as an image sizing takes ages to ship not to mention tons of other issues that take ages to solve. very frustrating

1 vote
Nick Perkins October 8, 2021

Created an awesome README in Github.  Bitbucket.....please consider support proper HTML in your READMEs.  

1 vote
smac89 March 29, 2021

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

1 vote
msoutopico June 8, 2020

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

1 vote
Rajitha Kumara April 1, 2020

Any updates???

1 vote
Jonas Anderö March 18, 2020

Plz fix

1 vote
Jared Steffen February 20, 2020

Will this ever be fixed?

1 vote
sejhemming February 22, 2019

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

I'd really like to see this functionality added

0 votes
Vladimir Covaliov February 26, 2021

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 https://atlaskit.atlassian.com/examples/editor/editor-markdown-transformer/markdown-transformer consistent with how bitbucket displays markdown. Is there any other tool I can use?

Daniel Eck March 4, 2021

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

Carlos Davila March 11, 2021

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.

smac89 March 29, 2021

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

0 votes
venomDev August 28, 2018

No delete answer?

Suggest an answer

Log in or Sign up to answer
TAGS
AUG Leaders

Atlassian Community Events