Skip to main content
How to insert Markdown

Enhance you Confluence pages with rich Markdown content, with support for advanced features, like images, links, diagrams and more.

Updated over a week ago

Markdown is a lightweight markup language that allows you to add formatting elements to plain text, making it an essential tool for creating organized and visually appealing content.

In this article, we'll explore how to incorporate Markdown into your pages, including advanced features such as images, links, diagrams, and more. By the end of this guide, you'll be equipped to transform your Confluence pages into dynamic and information-rich documents using Markdown.

Let's get started and unlock the full potential of your content!
โ€‹

Animated guide

Follow along with the video below to learn how to insert images.

Step-by-Step

Alternatively, follow the step by step guide below:

1. Open the editor for a new or existing Confluence page

Choose where to insert the Markdown.

Open the editor for a new or existing Confluence page

2. Insert the Markdown Macro

Either click on the '+' in the editor toolbar and select Markdown, or type /markdown

Insert the Markdown Macro

3. Choose which source to insert the Markdown from

Here you can choose where to add the Markdown from, either (a) from a URL, (b) from scratch or (c) from a template.

Choose which source to insert the Markdown from

4. In this guide, we'll create a new Markdown from a template

In this guide, we'll create a new Markdown from a template

5. Edit the Markdown content accordingly

Edit the Markdown content accordingly

6. Once you're happy, click Insert

Once you're happy, click Insert

7. Your Markdown content is now embedded in the Confluence page

Your Markdown content is now embedded in the Confluence page

8. Click on Update to save your changes

Click on Update to save your changes

9. Your Markdown is now visible in the view page mode

You will find buttons to maximize and edit the content in the top right.

Your Markdown is now visible in the view page mode

10. In edit mode you can change the title and content of the Markdown easily

Click on the maximize button to get a larger view for updating the content.

In edit mode you can change the title and content of the Markdown easily
Did this answer your question?