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

Markdown rendered on Bitbucket is unreadable is there an alternative (asciidoc)?

I edit my documentation in my IDE (IntelliJ) and I am able to preview the output but after I push to bitbucket the rendered HTML is unreadable. I have seen other discussions from 2018 about this issue but this is still happening. Frustrated as this seems like a simple transformation from Markdown to HTML. Is Asciidoc supported in Bitbucket? Is there an alternative to Markdown?

1 answer

0 votes
Tyler T Atlassian Team Sep 15, 2020

In your Labs settings, can you try enabling/disabling the Embedded HTML in Markdown feature and see if that makes a difference?

Screen Shot 2020-09-15 at 4.45.11 PM.png

I don't have permission nor do I want to change Bitbucket settings to get my Markdown documents to render correctly. Is there a documented list of Markdown features Bitbucket supports? I just want my rendered documents to be readadle. Ideally I would like some of the features of AsciiDoc but just rendering a paragraph so it's readable from Bitbucket would be a small step forward.

Tyler T Atlassian Team Sep 15, 2020

That is a user feature so if you have an account (you are logged in) you can access that link. This will help us narrow in on your issue.

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 ...

1,587 views 0 6
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