Moving Confluence Markdown macros off Connect

Atlassian stopped accepting new Connect apps in September 2025 and stopped accepting Connect descriptor updates in March 2026. At end of support, in Q4 2026, installed Connect apps keep working but receive only critical or security fixes, and Atlassian has said it will notify customers in the Marketplace (Atlassian's announcement).

Markdown macros are easy to forget: someone installed one years ago, and now it sits on READMEs, runbooks and release notes that many people read. Moving them before anything breaks takes a few minutes per page.

1. As a Confluence admin, open Settings → Apps → Manage apps and look for the app that provides your Markdown macro.
2. Open its Marketplace listing. A Forge app built without external servers carries the Runs on Atlassian badge; a Connect app cannot. The Versions tab shows when it was last updated.
3. A common case is Render Markdown, a free Connect app whose macro is called markdown and whose Markdown is typed into the macro body. The steps below are written for it, and work the same for any macro that keeps its Markdown in the page.

Confluence's query language (CQL) can list every page that contains a macro by name. The query is macro = "markdown" and type = page. The simplest way to run it: while logged in to Confluence, open this address in the same browser, replacing your-site with your site name:

The browser shows the matching pages, each with its title and link. That list is your migration checklist; it only includes pages you are allowed to see, so run it as an admin. When the same address returns an empty list, the old macro is no longer used anywhere.

Markdown Viewer is one of the three macros in API Docs Macros for Confluence, a Forge app with the Runs on Atlassian badge: it renders inside your Confluence page and makes no external network calls. Both apps can be installed at the same time, so you can migrate gradually.

30-day free trial. Pricing is on the Marketplace listing.

Markdown typed in the page

1. Edit the page and open the old Markdown macro. Select all its text and copy it.
2. Next to it, type /markdown and insert Markdown Viewer.
3. Click the new macro, then the pencil icon. Under Document source choose Paste Markdown, paste the text and save.
4. Check the preview, delete the old macro and publish the page.

Long documents, or documents that live in a repository

1. Attach the .md file to the page (drag it onto the page while editing).
2. Insert Markdown Viewer and, under Document source, choose Page attachment and pick the file.
3. From then on, replacing the attachment updates the page. Images referenced with relative paths, like diagram.png, are taken from the page's attachments.

When the search from step 2 returns no pages, uninstall the old app from Settings → Apps → Manage apps. Questions about a specific page? Write to support@corventia.com and we will help.