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

[Jonathan Brinkley]

I have a CHANGELOG.md 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](https://bitbucket.org/{repository}/commits/tag/x.y.z) {Description} (YYYY-MM-DD)
### Improvements- [JIRA {issue id}](issue URL) {Description}

<br></br>
---
## [x.y.y](https://bitbucket.org/{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.

[Theodora Boudale · Accepted solution]

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. https://jira.atlassian.com/browse/BCLOUD-20746.

Kind regards,
Theodora

[Jonathan Brinkley]

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