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

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
Community showcase
Published Thursday in Agile

How Scrum works? It starts with training and education

To answer “How scrum works,” most of the teams I've worked with first addressed the question: “where to start?”  That question applies to both implementation and improvements on the Scrum framew...

202 views 3 6
Read article

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