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.

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.