Markup bridge documentation
Markup bridge adds two items to the ••• menu of every Confluence Cloud page:
- Markup: Export… downloads the page, and optionally all its child pages, as a zip of Markdown, AsciiDoc, reStructuredText, Typst or LaTeX files, with the images and attachments.
- Markup: Import… turns those files back into pages: new pages under the current page, or updates to the pages the files were exported from.
Confluence lists both items under ••• › Apps.
How it works
The conversion runs in your browser, inside the dialog. Every request to Confluence is made as you, so the app sees exactly the pages and spaces you can see, and nothing more. There is no Markup bridge server: your pages are never sent to us or to anyone else.
Common uses
- Docs in Git. Export a page tree, commit it, and review changes as diffs. Import the files to update the pages after the changes are merged.
- Editing in your own editor. Export a page, edit it in VS Code, Vim or any other editor, and import it to update the page.
- Publishing. Export to Markdown for MkDocs, Docusaurus or Hugo, to reStructuredText for Sphinx, or to AsciiDoc for Antora.
- Print and PDF. Export to LaTeX or Typst and typeset the pages.
- Moving content. Export from one site and import into another.
In this documentation
- Installing: installing the app, the free trial, and who can use it
- Exporting: the export dialog, the zip, and the limits
- Importing: which files you can import, and how they become pages
- Updating pages: a round trip through Git or an editor
- Formats: what each format looks like, and how to render it
- Troubleshooting: the messages the dialog shows, and what to do