FAQ

Data and security

Does our content leave Atlassian?

No. The app declares no external network access at all. Conversion happens inside Atlassian Forge.

Can the app change our pages?

Only through an import you start, and only underneath a page you created yourself in that same run. Nothing in the export path writes anything. The app cannot delete a page at all.

Where does an export file live before I download it?

In the app's storage inside your own Confluence site, until you download it, reset the job, or uninstall the app.

Can somebody export a space they cannot read?

No. Exports run with your own Confluence permissions, and restricted pages are skipped.

Can somebody import into a space they cannot write to?

No. The import creates its root page as you, before anything is queued — if Confluence refuses that, the job stops and nothing else is written.

Does it use AI?

No. Conversion is deterministic.

Export

Can I import Markdown files and turn them into Confluence pages?

Yes — the Import tab. Drop a .zip or loose .md files: the folder structure becomes the page tree, images the pages refer to are uploaded, and links between the files become links between the pages. See Importing Markdown.

What is the difference between the five export destinations?

They decide where a page with children is written, what carries the page order, and how files link to each other — Obsidian gets wikilinks, Docusaurus and Hugo put parents in an index file and read the order from front matter. The table is here.

Can I export from Confluence and import back later?

Yes, and the Plain Markdown destination is built for it: a page sits beside its children's folder, which is exactly the shape the import reads. Front matter carries the real page titles, so a title with characters a filename cannot hold survives the trip.

Can I export a whole space?

Yes, with Export Entire Space. For very large spaces, export branch by branch instead.

Are attachments included?

Only if you enable Include attachments. Then the files are downloaded and the links are rewritten to point at them.

How faithful is the Markdown?

Text, headings, lists, tables, links, images, code blocks and info/note/warning panels all convert. Confluence macros with no Markdown equivalent cannot: the export leaves a comment naming the macro where it was.

Do I need to be an admin?

No. The Markdown Toolkit page is in the space sidebar and anyone who can open the space can use it — you simply cannot export a page you could not already read. Importing needs permission to add pages to that space, which is a space permission, not administrator rights.

The macro

Which Mermaid diagrams does it support?

Twenty-one types, from flowcharts and sequence diagrams to Gantt charts, Sankey diagrams, radar charts and C4 context diagrams. The gallery renders one of each.

Does it support maths?

Yes, LaTeX between $…$ or $$…$$, rendered with KaTeX.

Does it follow Confluence's dark mode?

Yes. The macro reads the page's colour mode and re-renders when it changes, rather than reloading.

Can I search macro content in Confluence?

Confluence indexes what it stores for the page. Treat the macro as a rendering block, not as a replacement for page text you rely on search to find.

What happens to macros if I uninstall the app?

The macro content is cleared and detached immediately, and the macro stops rendering. Export the pages that matter before removing the app. See Where your data goes.