Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

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

Why does Bitbucket render Markdown files (.md) file differently than CommonMark?

I have a file that I have created for my respoitory where I list the issues resolved in the latest release of code.  I am using the following syntax between release entries:

## [x.y.z]({repository}/commits/tag/x.y.z) {Description} (YYYY-MM-DD)
### Improvements- [JIRA {issue id}](issue URL) {Description}

## [x.y.y]({repository}/commits/tag/x.y.y) {Description} (YYYY-MM-DD)


The problem comes up when I try view the file online in Bitbucket its not ignoring the break (<br></br>).  When I view this in CommonMark the reference provided in the documentation it works as expected, but not when I view the file online in Bitbucket.

1 answer

1 accepted

0 votes
Answer accepted

Hi Jonathan,

I'm afraid that we don't support arbitrary HTML in Markdown, which is why you can view <br></br> in your .md file instead of a line break.

That being said, we have a Labs feature to allow some HTML tags to be embedded in markdown files.

If you log in to Bitbucket Cloud website, then go to your avatar > Labs, you can find and enable Embedded HTML in markdown. After you do, you can edit the file and after committing changes, <br></br> should no longer be displayed.

Please note that this feature is still in Beta, so there are some bugs related to it, e.g.

Kind regards,

Thank you I will wait for the changes to come out of beta.

Like Theodora Boudale likes this

Suggest an answer

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

New improvements to user management in Bitbucket Cloud 👥

Hey Community! We’re willing to wager that quite a few of you not only use Bitbucket, but administer it too. Our team is excited to share that we’ll be releasing improvements throughout this month of...

3,920 views 10 16
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