Can you turn the Atlassian/Confluence Markup off and Markdown On?

I despise the Atlassian/Confluence Markup and the way the Confluence and JIRA editors handle it. 

Is there a way to completely disable it and use Markdown instead?

If you want to reference code in markdown it takes <2 seconds to add the ` char around it. But in Atlassian/Confluence Markup it's an absolute pain every time. Using the `Preformatted` works horribly because the editor forces you to a new line.

The `Import Markup` and then pasting in Markdown works, but it's a one-time thing. So I've started keeping my documentation in a GIT repo in Markdown format and every time I want to change it I use a real Markdown editor and paste it in. And when others update Confluence, I have to manually merge their changes. Not cool.

1 answer

0 vote
Stephen Deutsch Community Champion May 29, 2017

If you want to just use Markdown, why not use one of the plugins that renders Markdown in Confluence? There are some free options:


Markdown Macro for Confluence


Render Markdown

Note that you won't be able to embed Confluence macros inside, so you'd have to break your markdown in pieces (i.e. insert multiple macros as such: Markdown macro, Confluence Macro, another Markdown macro for the rest of your text, etc.).

Suggest an answer

Log in or Join to answer
Community showcase
Louis De Jaeger
Posted yesterday in Off-topic

Friday fun: your best joke

Hi all Lets make this Friday fun really fun and post one (or more) of your best jokes! The joke can be about an Atlassian product, or just a really fun joke you want to share! I’m not the best j...

61 views 2 2
Join discussion

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you
Atlassian Team Tour

Join us on the Team Tour

We're bringing product updates and pro tips on teamwork to ten cities around the world.

Save your spot