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

Wiki Markdown display differs from Edit Preview

I'm not sure whether I'm complete mislooking this functionality, but I'm not able to get my wiki work.

Markdown elements are perfectly converted/applied in the Edit > Preview, but NOT in the wiki-url display. 

Some examples:

  • # Heading one
    when showing in preview, this has 'markdown-heading-heading-one' as ID anchor
    when showing in BitBucket wiki no id is generated, but text is wrapped in <h1>
  • [TOC]
    when showing in preview, a complete Table Of Content is generated, with working links
    when showing in Bitbucket wiki '[TOC]' is shown.

So it kind of seems the Bitbucket wiki display uses different libraries to process the markdown to display in the front-end (end-users) vs. what is shown in Preview.

Is this a known issue, or maybe some repository settings I'm missing?

Thanks in advance! 



1) Create new Wiki page and click Preview (then you'll see the heading, horizontal lines and the Table of Content and the horizontal lines); Inspecting the headings you'll see 'markdown-heading-one' as example ID for the <h1>

# Heading One #
This is some nice text

## With sub title ##

Some additional text 





2) Now save the wiki page and move out of Editor mode towards the page, there you'll see the heading and horizontal lines but [TOC] is not replaced and no anchor-ids are generated for the <h1>-tags

1 answer

1 vote

Hi @rvandenassum ,

I believe these issues are related to the Lab feature Embedded HTML in markdown which is still in Beta. We have a bug report regarding the issue with TOC:

You can go to your avatar (bottom left corner in Bitbucket website) > Labs and disable this specific one. You may also need to Edit the wiki page and Save it (with no need to make any actual changes) after you turn off the Lab feature to be able to view the table of content and the header ids.

Is this something that works for you?

Kind regards,

Hi @Theodora Boudale , you're my hero! 

This indeed did the trick, will inform rest of my team. Thanks!

Like Theodora Boudale likes this

Great, you are very welcome!

Suggest an answer

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

📣 Calling Bitbucket Data Center customers to participate in research

Hi everyone, Are you Bitbucket DC customer? If so, we'd love to talk to you! Our team wants to dive deep to understand your long-term plans regarding Bitbucket DC and Atlassian Cloud. Do you plan...

119 views 2 4
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