Confluence to Markdown

Download Confluence pages as Markdown, edit them in VS Code, and publish them back. The extension works with Confluence Cloud and Server/Data Center.

No telemetry. The extension connects only to the Confluence host in the link you provide. No Confluence addresses are built into the code.

Setup

Add your credentials in the extension settings:

• Cloud: set confluenceToMd.token to an Atlassian API token and confluenceToMd.email to your Atlassian account e-mail.
• Server/Data Center: set confluenceToMd.token to a Personal Access Token from your Confluence profile.

You do not need to configure an instance address. The extension reads the host, context path, and Confluence type from each link, so you can work with multiple instances. If no token is set, the extension offers to open the settings.

Download pages

1. Run Confluence: Download Page.
2. Paste the full page link. Cloud, Server/Data Center, short /x/... links, context paths, and non-standard ports are supported.
3. Choose which linked pages to download too.

Each page is saved as a separate file with its Confluence binding. Child pages follow the Confluence page tree, and links between saved pages become relative Markdown links.

See Downloading pages for save locations, link handling, images, and extracted code samples.

Update a page from Confluence

A downloaded file can be refreshed from Confluence, like git pull. Open the Markdown preview: a file bound to a page shows a small ↻ Pull button in its top right corner. You can also run Confluence: Pull Page in the editor.

The extension compares versions first. If the file is up to date, nothing changes. Otherwise it asks before replacing the file content with the current page, because edits you have not published are lost. Compare shows the differences first without changing the file.

See Downloading pages for details.

Publish a page

Open a Markdown file and run Confluence: Publish Page. For a bound file you can also click ↑ Publish in the top right corner of the Markdown preview; it asks first and saves unsaved edits before publishing.

• A file with a confluence: front matter block updates its bound page. If someone changed the page since your version, the extension asks first and offers Compare, which shows their changes next to your file.
• A file without a binding creates a page under the parent whose link you provide. The new binding is added to the file.

See Publishing pages for the binding format, split documents, conversion details, and round-trip limitations.

Settings

The token is stored in VS Code settings, which may be synced or shared. Restricted Mode is supported.