Forums

Articles
Create
cancel
Showing results for 
Search instead for 
Did you mean: 

How to insert markdown text into my Confluence Page?

Alan Moore
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
June 3, 2025

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:
Screenshot 2025-06-03 at 4.39.33 PM.png

4 answers

2 accepted

1 vote
Answer accepted
Stephen Deutsch
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
June 5, 2025

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
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
June 5, 2025

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

0 votes
Answer accepted
Alan Moore
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
June 5, 2025

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!

1 vote
Pierre Rutsch June 4, 2025

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'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
June 4, 2025

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

1 vote
Piyush Annadate _ACE Pune_
Community Champion
June 3, 2025

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
I'm New Here
I'm New Here
Those new to the Atlassian Community have posted less than three times. Give them a warm welcome!
June 4, 2025

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

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PRODUCT PLAN
STANDARD
TAGS
AUG Leaders

Atlassian Community Events