Markdown to Confluence Converter

Example Input and Output

## Deploy steps

```bash
npm run build
npm run deploy
```

> Warning: deploy only from main.

h2. Deploy steps

{code:language=bash}
npm run build
npm run deploy
{code}

{warning}
deploy only from main.
{warning}

## Rollback

> Note: Only rollback after checking error rates.

1. Open the deploy dashboard
2. Select the previous version
3. Confirm rollback

h2. Rollback

{note}
Only rollback after checking error rates.
{note}

# Open the deploy dashboard
# Select the previous version
# Confirm rollback

| Option | Pros | Cons |
| --- | --- | --- |
| Keep API | stable | slower |
| Replace API | faster | migration work |

|| Option || Pros || Cons ||
| Keep API | stable | slower |
| Replace API | faster | migration work |

How to Use Markdown to Confluence Converter

1. Open the Markdown to Confluence converter
2. Choose a starter template if you need a runbook, technical spec, incident review, or meeting notes page
3. Paste your Markdown document, runbook, release note, or technical spec
4. Review the generated Confluence wiki markup and macros
5. Copy the output
6. Paste it into a Confluence page or editor that accepts wiki markup

Frequently Asked Questions

Does Confluence support Markdown?

Only partly. Confluence Cloud accepts a few Markdown shortcuts while you type, such as # for headings and ** for bold, but it does not import a full Markdown file. Tables, fenced code blocks, and nested lists paste as plain text. Convert the Markdown to Confluence wiki markup or storage format first, then paste.

How do I convert MD to Confluence?

Paste the contents of your .md file into the converter above. Choose wiki markup or storage format. Copy the output. In Confluence, open the page editor, insert the Markup macro (wiki) or paste into the source editor (storage format), and save. The headings, tables, code blocks, and links keep their structure.

Markdown to Confluence vs Jira: what is the difference?

Both use Atlassian wiki markup, so headings, bold, lists, and tables convert the same way. Confluence adds page macros such as {info}, {warning}, {note}, and {panel}, and supports storage format XHTML. Jira issue fields do not. Use this tool for Confluence pages and the Markdown to Jira converter for issue descriptions and comments.

How is Confluence markup different from Jira markup?

Confluence and Jira share the same wiki markup base, but Confluence adds macros like {info}, {warning}, {note}, {tip}, and {panel} for structured content. Code blocks use {code:language=python} syntax.

Does this handle Confluence macros?

Yes, blockquotes starting with Note:, Warning:, Info:, or Tip: are automatically converted to the corresponding Confluence macros ({note}, {warning}, {info}, {tip}).

Can I start with a Confluence template?

Yes. The tool includes starter Markdown templates for runbooks, technical specs, incident reviews, and meeting notes, then converts them to Confluence wiki markup.

Can I use this for Confluence Cloud and Data Center?

Yes, the wiki markup syntax works for both Confluence Cloud and Confluence Data Center (Server).

How are code blocks converted?

Markdown fenced code blocks (```python) are converted to Confluence {code:language=python} syntax, which enables syntax highlighting in Confluence.

Can I convert Markdown tables to Confluence?

Yes. Markdown pipe tables are converted to Confluence wiki table syntax so you can move specs, release notes, and runbooks into Confluence faster.

What Markdown is best for Confluence import?

Use clear headings, bullet lists, fenced code blocks with language names, normal Markdown links, and simple pipe tables. Avoid custom HTML if you want the cleanest Confluence output.

Guides for this tool

Use a focused example when you need platform-specific syntax or a repeatable document workflow.

Related converters

Same document, a different destination. Each converter handles the syntax that the target tool accepts, in both directions.

• Markdown to Jira converter — Wiki markup for issue descriptions, acceptance criteria, and QA repro steps.
• Jira to Markdown converter — The reverse direction: Jira wiki markup back to clean Markdown.
• Confluence to Markdown converter — Confluence storage format or wiki markup back to standard Markdown.
• Markdown to Notion converter — Notion-ready text that pastes with nesting, tables, and code blocks intact.
• Notion to Markdown converter — Strip Notion export artifacts and encoded URLs to get clean Markdown.
• Markdown to Email HTML converter — Inline-styled HTML that keeps its formatting in Gmail and Outlook.