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 Sign up to answer
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Posted Tuesday in Uncategorized

Friday fun: how many celebrates Midsummer holiday or is this a Swedish tradition only?

Any other country that celebrates Midsummer holiday (this friday 22 June)?  

46 views 3 1
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