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

Bitbucket Wikis Mermaid support ?


We recently had to switch from Gitlab to Bitbucket, and so transferred a wiki along with our project code base.

We used [Mermaid]( extensively to  produce schemas of our project internal processes, and after the transfer the schemas markdown do not seem interpreted properly.

I saw there is a [Mermaid Confluence Plugin](, but is there a way to get this support into our Bitbucket wiki ?

1 answer

1 accepted

4 votes
Answer accepted


Thanks for switching over from Gitlab to Bitbucket and providing feedback on the Bitbucket wiki. Currently, Bitbucket Cloud only supports Markdown (CommonMark). Further information on the markdown may be found at Markdown syntax guide.

The good news is there is a feature request already created to support Mermaid within Bitbucket cloud. You may find this request at Please implement Mermaid markdown live preview. We would suggest voting and watching this request to receive future updates for its status.

While this is not a solution, I hope the information proves helpful and the feature request assists with ensuring your feedback gets to the right place.

Stephen Sifers

Thanks for the information. Bad news for us for now but hope it will come soon.

Like # people like this

Omg why your Markdown support is so limited so weak compared to Gitlab, Github ... Yet your service is paying, we would have hoped a extended markdown syntax support.

Like # people like this

Stephen, thank you for pointing us in the right direction to express interest in escalating the priority of adding this much used feature to your product.

Like # people like this

Any update on that aspect ? Support for MErmaid would be very much welcomed.


There are more than 250 upvote on this jira.
Did you plan to implement it?


Oh, the plugin in the marketplace is broken because Atlassian (now?) requires a REST API endpoint for `installed` and `uninstalled`.   The marketplace plugin is served from the static pages so there's no REST API to hit.

I implemented a CDK stack in AWS which basically creates a dumb endpoint for the installation to hit and blammo it works for us.  I also updated the version of the mermaid js library.  

At this point it's running internally so I can't make the endpoint/product nor the code public.  (I will see about at least open-sourcing this if I ever have some time..)

unlucky you that you had to change from gitlab to bitbucket... anyway to late to regret it and now your stuck with this.
as always with Atlassian never expect them to deliver any feature request

Suggest an answer

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

⭐ Calling all Bitbucket and DevOps experts: Special showcase opportunity ⭐

Hi, Bitbucket community! Are you a DevOps practitioner (or know one in your network)? Do you have DevOps tips, tricks, or learnings you'd like to share with the community? If so, we'd love to hea...

1,454 views 4 7
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