How to insert markdown text into my Confluence Page?

[Alan Moore]

I am attempting to insert markdown text into an existing Confluence page and it keeps displaying the markdown as a code snippet rather than interpreting the markdown and translating into Confluence format.  I tried `/markdown` but that did nothing and I was unable to find any Markdown or Markup macros under the `+` menu.

For example, I inserted this:

## Overview

and Confluence did this:

[Alan Moore · Accepted solution]

For anybody coming upon this thread in the future, I did actually figure out a way to make this work.  Using my markdown preview in my IntelliJ IDEA editor, I copied and pasted the formatted text (not the markdown text) into confluence and that worked perfectly!

[Stephen Deutsch · Accepted solution]

Hello Alan,

If it's an option for you to be able to install an app, you could try using this app: Render Markdown 

This would allow you to keep your text in markdown format.

As the other answerers have stated, there used to be an easy way to convert markdown text in the old editor, but this was removed in the new editor, and while you can type markdown line by line, there's no easy way to convert multiple lines.

To tell if you're in new/old editor mode, the old editor will have a "publish" button at the bottom of the page, and the new editor will have an "update" button at the top of the page.

[Alan Moore]

Thanks Stephen, you managed to answer all of my questions at once!

[Pierre Rutsch]

Hi @Alan Moore ,
Welcome to the Atlassian Community!

It looks like the issue could be related to the New Editor in Confluence, which doesn’t support Markdown in the same way as the legacy editor. Here’s what you can try:

Check if your page is in the New Editor mode: The New Editor might not properly render Markdown as it would in the legacy editor. If you’re using the New Editor, consider switching to the Legacy Editor by clicking on the three dots in the top right corner of the page and selecting "Switch to legacy editor".

Markdown in Confluence: For Confluence Cloud, Markdown macros are not available directly. However, you can use other formatting options, like Headings or Tables, within the editor.

Reference Documentation: Here’s a guide that might help you with available Markdown commands: Markdown commands in Confluence.

Let me know if this helps or if you need more assistance!

[Alan Moore]

I don't see a "Switch to legacy editor" option under the three dots.  

[Piyush Annadate _ACE Pune_]

Hello @Alan Moore ,
Welcome to the Atlassian Community!

Can you confirm if your page is in NEW EDITOR mode?

Additional reference for markdown notes: https://support.atlassian.com/confluence-cloud/docs/available-markdown-commands/

[Alan Moore]

How do I determine if I'm in NEW EDITOR mode?

[Bruno Weinek]

I am really confused. For me pasting the RAW markdown works flawlessly. I get a beautiful rendered markdown page, not a code snippet and also not the raw markdown as text, but... (i am using brave).

but someone else in my company has the exact same issue as the op.

For them pasting the raw markdown from vs code produces a code snippet. This happens in firefox and google chrome, but when they find a special place in the page where a right click create a context menu where they can say, "paste without formatting" then they also get a beautiful renered markdown page (in both firefox and google chrome).

In brave though, paste without formatting gets me the raw markdown inserted as text not as a code snippet...

[singhbit]

I used "</> Markup" macro and paste the markdown code directly in its text window and changed the type to `Markdown` from the Insert dropdown menu above text window.  The default is 'Confluence wiki' and needs to be changed to 'Markdown'.  It worked for me to render Markdown.