MarkdownKit for Confluence
Import Markdown into Confluence, export Confluence to Markdown, and render Markdown on any page.
Import Markdown
Open MarkdownKit from the space sidebar (under Space apps) or from the Apps menu.
- Choose the destination space and, optionally, a parent page.
- Drop Markdown files, a folder, or a
.zip— or use the buttons to pick them. - Review the page tree preview, then select Import.
What gets converted
| Markdown | Confluence |
|---|---|
| Folders | Page hierarchy. A folder's README.md or index.md becomes the folder's page; folders without one get a page listing their children. |
| Page title | Front matter title, else the first # Heading, else the file name. |
Front matter labels / tags | Page labels |
| Relative images and linked files | Uploaded as attachments on the page |
Links to other .md files in the upload | Confluence page links |
| Fenced code blocks | Code blocks with the language set |
- [ ] / - [x] | Task lists |
> [!NOTE], [!TIP], [!WARNING], [!CAUTION] | Info, tip, warning and error panels |
| Tables, headings, lists, quotes, links | Native equivalents |
When a title already exists
Confluence page titles are unique within a space. Choose whether to update the existing page, skip it, or create a renamed copy.
Errors
Each page reports its own result. A page that fails does not stop the others, and Retry failed re-runs only the pages that failed. Missing images or link targets are listed as warnings beside the page.
Raw HTML inside Markdown is imported as text rather than interpreted.
Export to Markdown
A whole space or page tree
In MarkdownKit, open the Export to Markdown tab, choose a space, optionally a starting page, and select Export as .zip.
- Mirror the page tree as folders — pages with children become
Title/README.md. - YAML front matter — title, page id, URL and labels.
- Include images and attachments — saved in an
attachmentsfolder beside the page. - Combined file — also writes
_all-pages.md, convenient for AI tools.
Links between exported pages become relative links; links to pages outside the export point to the live page.
A single page
On any page, open ••• → Apps → Export to Markdown to preview, copy or download the page, or download it together with its child pages.
Macros without a Markdown equivalent are exported as an HTML comment naming the macro.
Markdown macro
In the editor type /markdown and choose Markdown.
- Write Markdown — edit on the left, live preview on the right.
- Render a .md attachment — pick a Markdown file attached to the page; the macro updates when the attachment does.
The macro supports tables, task lists, syntax-highlighted code and Mermaid diagrams (use a mermaid code block). It follows the light or dark theme and is included in PDF and Word exports.
Permissions
MarkdownKit acts as the person using it: it can only read and create pages that person is already allowed to.