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

Next challenges

Recent achievements

  • Global
  • Personal


  • Give kudos
  • Received
  • Given


  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

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

Powering DevOps with Bitbucket Server & Data Center

Hi everyone, The Cloud team recently announced 12 new DevOps features that help developers ship better code, faster   ! While we’re all excited about the new improvements to Bitbucket ...

2,589 views 1 9
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