Markdown to Confluence
Move Markdown into Confluence pages with headings, tables, and code blocks intact.
Prepare your Markdown
Use the Markdown to HTML tool, then paste the result into Confluence.
About Markdown in Confluence
Atlassian Confluence uses its own "storage format" — an XML-based dialect that's neither HTML nor Markdown. The reliable interchange path is Markdown → HTML → paste into Confluence's editor, which converts pasted HTML to storage format on save. Macros like `{code}`, `{info}`, `{warning}`, and `{toc}` don't have Markdown equivalents — they're added after import via Confluence's `/` menu. Confluence preserves heading hierarchy, tables, and code blocks reliably; nested lists deeper than three levels often need manual cleanup. For Confluence Cloud, the new editor handles pasted HTML cleanly; Confluence Data Center has stricter parsing.
Confluence-specific workflow
- Convert your Markdown to HTML first using tinyMD's Markdown to HTML tool.
- Open a new or existing Confluence page in the editor.
- Paste the HTML — Confluence parses headings, lists, tables, and code blocks automatically.
- Add Confluence-specific macros (info panels, code-with-language) via the `/` menu after import.
Confluence workflow scenarios
- Publish README or design docs written in Git to a team Confluence space.
- Migrate engineering notes from Markdown into Confluence without retyping tables.
- Keep Markdown as the source of truth and refresh the Confluence copy after edits.
FAQ
Can I paste Markdown straight into Confluence?
Simple Markdown often survives a direct paste, but tables, nested lists, and code blocks are more reliable when you convert first with the recommended tinyMD tool and paste the result into Confluence.
Does tinyMD upload my Markdown while preparing it for Confluence?
No. tinyMD tools run in your browser, so your source files stay on your device while you convert and copy the output.
Other platform guides
Related articles
Privacy & reliability
tinyMD tools run in your browser and keep your source documents local. This helps with sensitive documentation and fast iteration without upload delays.