Skip to converter

ConvertToConfluence

Convert Markdown and DOCX to Confluence format. Paste markdown, preview the result, and publish directly — no more broken formatting when pasting into Confluence.

Free, no account. Built in Berlin by mtc.berlin

Your output will appear here

Run a conversion to see the report

How it works

Pasting markdown into Confluence often breaks formatting — headings disappear, lists flatten, code blocks lose syntax highlighting. ConvertToConfluence converts your Markdown or DOCX to the Atlassian Document Format (ADF) that Confluence actually understands.

  1. 1

    Input

    Paste Markdown into the editor or upload a .md or .docx file. Conversion starts automatically.

  2. 2

    Preview & ADF

    See a live preview of how your content will look in Confluence, or switch to the ADF JSON tab for the raw output.

  3. 3

    Review

    Check the conversion report for warnings or errors. Enable accessibility checks to catch missing alt text or skipped headings.

  4. 4

    Publish

    Copy the rendered preview into Confluence or Jira, or publish directly via the Confluence API with your token.

What you get

Confluence's editor does not reliably import Markdown. Pasting from VS Code, GitHub, or a README often produces garbled output. This tool converts markdown to Confluence format correctly — including DOCX to Confluence conversion.

  • Headings, lists, tables, code blocks, and inline formatting preserved.
  • Image references converted to Confluence media nodes.
  • Live preview of the converted output.
  • Conversion report showing what was mapped and what needs attention.
  • Direct publish to Confluence via API.

Conversion report

Every conversion produces a report below the output panel. It tells you exactly what happened to your content.

  • OK

    Elements that converted cleanly — headings, paragraphs, lists, code blocks, etc.

  • Warnings

    Content that converted but may need a manual check — unsupported nesting, complex tables, or unknown markup.

  • Errors

    Elements that could not be mapped to ADF. The report includes the line number so you can fix the source.

The report also includes optional accessibility checks — missing alt text on images, skipped heading levels, and empty links. Toggle them on in the report panel.

What is ADF?

Atlassian Document Format (ADF) is the JSON-based document structure used by Confluence and Jira. It replaced the older wiki markup and storage format. Every page you create in Confluence Cloud is stored as ADF internally.

ADF represents content as a tree of typed nodes — paragraphs, headings, tables, code blocks, media, and more. The ADF JSON tab in the converter shows this raw structure. You can use it with the Confluence REST API to create or update pages programmatically.

Setting up your API token

To publish directly to Confluence, you need an Atlassian API token.

  1. Go to id.atlassian.com/manage-profile/security/api-tokens.
  2. Click Create API token, give it a label.
  3. Copy the token and paste it into the API Key dialog on this page.
  4. Enter your Confluence base URL (e.g. https://yourcompany.atlassian.net/wiki) and your Atlassian email.

The token is stored in your browser only. It is never sent to our servers.

Works with Jira too

Jira issue descriptions and comments use the same rich-text editor as Confluence. You can use the converted output in Jira:

  1. Paste your Markdown or upload a DOCX file.
  2. Switch to the Preview tab on the right.
  3. Select the rendered content and copy it (Ctrl+C / Cmd+C).
  4. Paste directly into a Jira issue description or comment. Formatting is preserved.

Privacy

No account required. Conversion runs entirely in your browser — no data is sent to a server. Publishing uses your Confluence API token directly.

FAQ

Does Confluence support Markdown natively?

Partially. While typing, the Confluence Cloud editor autoformats some Markdown shortcuts like headings and lists. Pasting Markdown sometimes converts, but the result depends on where you copied from, and complex tables, footnotes or inline HTML lose fidelity. You also cannot keep editing the content as Markdown afterwards. Converting to ADF first gives you a reliable, predictable result.

Why does my Markdown table break when I paste it into Confluence?

Confluence's paste conversion is source-dependent and often loses table structure. This converter parses your Markdown (including GFM tables) into proper ADF table nodes. Copy the preview as rich text and the table arrives intact.

How do I import a Markdown file into Confluence?

Confluence Cloud has no direct .md file import. Upload or drop your .md file here, check the preview, then either copy the result as rich text into your page or publish it directly via the Confluence API.

Should I use Confluence's built-in Word import or this converter?

Confluence can import Word documents natively, which creates a page from the file in one step. Use this converter when you want control over the outcome: a live preview before anything lands in Confluence, an accessibility check on the content, and the raw ADF if you need it.

What is ADF (Atlassian Document Format)?

Atlassian Document Format (ADF) is the JSON-based document structure used by Confluence and Jira. It replaced the older wiki markup and storage format. Every page you create in Confluence Cloud is stored as ADF internally. ADF represents content as a tree of typed nodes — paragraphs, headings, tables, code blocks, media, and more.

How do I set up an Atlassian API token for publishing?

Go to id.atlassian.com/manage-profile/security/api-tokens, click "Create API token" and give it a label. Copy the token and paste it into the API Key dialog on ConvertToConfluence. Enter your Confluence base URL (e.g. https://yourcompany.atlassian.net/wiki) and your Atlassian email. The token is stored in your browser only and never sent to our servers.

Does ConvertToConfluence work with Jira?

Yes. Jira issue descriptions and comments use the same rich-text editor as Confluence. Paste your Markdown or upload a DOCX file, switch to the Preview tab, copy the rendered content, and paste it directly into a Jira issue description or comment. Formatting is preserved.

Is my data sent to a server?

No. Conversion runs entirely in your browser — no data is sent to a server. No account is required. When publishing to Confluence, your API token is used directly from your browser to the Confluence API.

Who is behind ConvertToConfluence?

ConvertToConfluence is a free tool by Moving Targets Consulting GmbH (mtc), an IT consulting company from Berlin-Kreuzberg, founded in 1997. mtc builds custom software, runs application support for large organizations, and makes digital products accessible. More at https://mtc.berlin.

Made by mtc

ConvertToConfluence is a free tool by mtc, an IT consulting company from Berlin-Kreuzberg. Since 1997 we build custom software, run application support for large organizations, and make digital products accessible. The accessibility checks in this converter come straight from that practice.

mtc is certified to ISO 27001 (information security) and ISO 9001 (quality management).

Meet mtc

More tools by mtc

xcheck.dev Audit your website for agent-readiness, accessibility, SEO and performance. patscenar.io Develop your patent strategy with scenario-based guidance. depa.tech Patent publication data from major offices, as a developer API. Patent Intelligence Reports AI-powered analyses of global patent portfolios on PATSTAT data. Patent Classification Explorer Browse and compare the IPC and CPC classification systems, free.