# Enhanced Markdown Setup Tutorial — Insert Macro, Modes & Publish

May 6, 2026 ·

<!-- -->

4 min read

[NGPilot](https://ngpilot.com)

<!-- -->

**Confluence Markdown** support lets developers write documentation in their preferred format. This guide covers how to add **Enhanced Markdown** to Confluence for raw Markdown editing, WYSIWYG preview, tables, code blocks, and more.

Who should read this

* Developers who prefer writing in Markdown
* Technical writers needing to import Markdown files
* Teams migrating from GitHub or other Markdown-based wikis

What you'll learn

1. How to install and use Enhanced Markdown in Confluence
2. Raw Markdown mode vs WYSIWYG mode
3. Supported syntax: tables, code blocks, task lists
4. Comparison with Confluence's native editor

## Does Confluence support Markdown?[​](#does-confluence-support-markdown "Direct link to Does Confluence support Markdown?")

No, Confluence does not natively support Markdown editing. The Confluence editor is a rich-text (WYSIWYG) editor. However, you can add Markdown support with a Marketplace app.

## Step-by-step: Write Markdown in Confluence[​](#step-by-step-write-markdown-in-confluence "Direct link to Step-by-step: Write Markdown in Confluence")

### Step 1: Install Enhanced Markdown[​](#step-1-install-enhanced-markdown "Direct link to Step 1: Install Enhanced Markdown")

Go to [Enhanced Markdown for Confluence](https://marketplace.atlassian.com/apps/1232856/enhanced-markdown-for-confluence?hosting=cloud\&tab=overview) on the Atlassian Marketplace and click **Get it now**. The app installs directly into your Confluence Cloud instance.

Enhanced Markdown is free for up to 10 users.

### Step 2: Open a Confluence page[​](#step-2-open-a-confluence-page "Direct link to Step 2: Open a Confluence page")

Navigate to the page where you want to write Markdown and click **Edit**.

### Step 3: Insert the macro[​](#step-3-insert-the-macro "Direct link to Step 3: Insert the macro")

Type `/enhanced markdown` in the Confluence editor and select the **Enhanced Markdown** macro from the dropdown.

### Step 4: Write your Markdown[​](#step-4-write-your-markdown "Direct link to Step 4: Write your Markdown")

The macro opens a Markdown editor. Write using standard Markdown syntax:

````
# Heading 1



## Heading 2



This is a paragraph with **bold text**, *italic text*, and `inline code`.



### Lists



- Unordered item 1

- Unordered item 2

  - Nested item



1. Ordered item 1

2. Ordered item 2



### Code blocks



```python

def hello():

    print("Hello, Confluence!")
````

### Tables[​](#tables "Direct link to Tables")

| Feature     | Supported |
| ----------- | --------- |
| Headings    | Yes       |
| Tables      | Yes       |
| Code blocks | Yes       |

### Task lists[​](#task-lists "Direct link to Task lists")

* <!-- -->
  Install Enhanced Markdown
* <!-- -->
  Write documentation
* <!-- -->
  Share with team

```


Enhanced Markdown supports **CommonMark** and **GitHub Flavored Markdown (GFM)**, including:



- Headings (H1–H6)

- Bold, italic, strikethrough

- Ordered and unordered lists

- Fenced code blocks with syntax highlighting

- Tables

- Task lists (checkboxes)

- Links and images

- Blockquotes

- Horizontal rules



### Step 5: Switch to WYSIWYG mode



Click the mode toggle to switch to **WYSIWYG mode**. In this mode you see the rendered result as you type — similar to Typora or Notion. You can also edit directly in WYSIWYG mode if you prefer.



### Step 6: Save



Click **Publish** or **Save**. The Markdown content renders as standard Confluence content. This means:



- **Exports work** — PDF and Word exports include the rendered content

- **Search works** — Confluence search indexes the content

- **Permissions work** — normal page permissions apply

- **Mentions and links work** — @mentions and Confluence links render normally



## What about inline Markdown in the Confluence editor?



Confluence's native editor does support a few Markdown shortcuts:



- Type `#` + space at the start of a line for a heading

- Type `-` + space for a bullet list

- Type `1.` + space for a numbered list

- Type `---` for a horizontal rule



But these are limited shortcuts, not full Markdown editing. For full Markdown support (tables, code blocks, task lists), you need Enhanced Markdown.



## Enhanced Markdown vs native Confluence editor



| Feature | Native Editor | Enhanced Markdown |

|---------|--------------|-------------------|

| Editing mode | WYSIWYG only | Raw Markdown + WYSIWYG |

| Markdown tables | No | Yes |

| Fenced code blocks | No | Yes |

| Task lists (checkboxes) | Partial | Yes |

| Syntax highlighting in code | No | Yes |

| PlantUML diagrams | No | Yes |

| Charts | No | Yes |

| Copy-paste from GitHub | Stripped | Renders correctly |



## Use cases



- **Developer documentation** — write docs in Markdown, the format developers know

- **API documentation** — fenced code blocks with syntax highlighting for endpoints

- **Knowledge base** — import existing Markdown files into Confluence

- **Meeting notes** — quick Markdown formatting without reaching for the mouse

- **README pages** — paste README.md content directly into Confluence



## Related resources



- [Enhanced Markdown — marketplace](https://marketplace.atlassian.com/apps/1232856/enhanced-markdown-for-confluence?hosting=cloud&tab=overview) | [documentation](/apps/enhanced-markdown-for-confluence)

- [Confluence Markdown vs WYSIWYG FAQ](/blog/faq-confluence-markdown-vs-wysiwyg)

- [Confluence Markdown editor FAQ](/blog/faq-confluence-markdown-editor)

- [Confluence Markdown editor comparison](/blog/confluence-markdown-editor-comparison)

- [Best Confluence apps for developers](/blog/best-confluence-apps-developers)



## More Related Guides



- [Markdown to Confluence converter](/blog/markdown-to-confluence-converter) — Import existing Markdown files

- [Confluence Markdown tables guide](/blog/confluence-markdown-tables) — Create tables in Markdown

- [Enhanced Markdown documentation](/apps/enhanced-markdown-for-confluence) — Complete feature guide
```

Try <!-- -->Enhanced Markdown for Confluence

Write Markdown with live split preview, Mermaid diagrams, KaTeX/LaTeX math, and 190+ code languages — all in one macro, free for up to 10 users.

[Get it on the Atlassian Marketplace](https://marketplace.atlassian.com/apps/1237026/enhanced-markdown-for-confluence?utm_source=ngpilot.com\&utm_medium=website\&utm_campaign=enhanced-markdown-for-confluence)

## Related guides

* [How to Write Markdown in Confluence](/blog/faq-confluence-markdown-editor.md)
* [How to Create Mermaid Diagrams in Jira](/blog/how-to-create-mermaid-diagrams-jira.md)
* [Export Jira Issues to Excel or CSV](/blog/export-jira-issues-to-excel.md)
* [Bulk Download Jira Attachments](/blog/bulk-download-jira-attachments.md)

Explore NGPILOT[Browse Solutions](/solutions.md)[All Apps](/apps.md)[Atlassian Marketplace →](https://marketplace.atlassian.com/vendors/1226848/?utm_source=ngpilot.com\&utm_medium=blog\&utm_campaign=hub-links)

**Tags:**

* [confluence](/blog/tags/confluence.md)
* [markdown](/blog/tags/markdown.md)
* [tutorial](/blog/tags/tutorial.md)
* [wysiwyg](/blog/tags/wysiwyg.md)
* [enhanced-markdown](/blog/tags/enhanced-markdown.md)