Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

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 ?

3 answers

1 accepted

6 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

Like # people like this
Joel Webb I'm New Here Jun 20, 2022

Any updates on this @Stephen Sifers

This is greatly needed for us as well. GitHub handles this natively.

Like Andreas likes this

you can try chome plugins -> markdown-diagrams

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events