How to Import Confluence Pages Into Notion

You have pages in Confluence that you want to move into Notion without losing the content or structure. Confluence and Notion use different database formats, so a direct copy-paste often breaks formatting, tables, and attachments. This article explains the two reliable methods to transfer Confluence pages into Notion: using the built-in Notion import tool for Markdown exports and using a manual copy-paste approach for complex pages. You will learn the exact steps for each method and what to do when the import produces unexpected results.

How Confluence and Notion Handle Page Data Differently

Confluence stores pages in a hierarchical tree using the Atlassian Document Format. Notion uses a block-based editor where every paragraph, heading, image, or table is a separate block. When you export from Confluence, the output is either HTML, PDF, or Markdown. Notion can parse HTML and Markdown, but it cannot read the native Confluence JSON format. This difference means that some Confluence-specific elements — like page macros, user mentions, and inline comments — will not survive the transfer. Understanding this limitation helps you decide which import method to use based on the complexity of your pages.

The most reliable path is to export Confluence pages as Markdown files and then use Notion’s built-in Markdown import. This method preserves headings, lists, tables, code blocks, and most inline formatting. For pages that contain embedded files, diagrams, or advanced macros, you may need to manually recreate those elements in Notion after the import.

Method 1: Export Confluence Pages as Markdown and Import Into Notion

This method works for Confluence Cloud and Confluence Server. It produces a folder of Markdown files that you can drag directly into Notion.

1. Go to the Confluence page you want to export
   Open the page in your browser. Click the three-dot menu icon near the top-right corner of the page.
2. Select Export from the menu
   Choose Export to PDF or Export to Word. For Markdown export, you need a third-party add-on or the built-in space export feature. Confluence Cloud does not have a native one-page Markdown export. Use the space-level export instead.
3. Export the entire space as HTML
   Go to Space settings > Content Tools > Export. Choose HTML as the export format. Click Export. Confluence will generate a ZIP file containing all pages as HTML files plus attachments.
4. Convert the HTML files to Markdown (optional but recommended)
   Use a tool like Pandoc to convert the HTML files to Markdown. Install Pandoc, then run this command in your terminal: pandoc input.html -o output.md. Repeat for each page you need.
5. Open Notion and create a new page
   In Notion, click the + New Page button in the sidebar. Give the page a title that matches your Confluence page name.
6. Drag the Markdown file into the Notion page
   Locate the .md file on your computer. Drag it directly into the blank Notion page. Notion will automatically parse the Markdown and create blocks for headings, lists, code, and tables.
7. Review and clean up the imported content
   Check for broken images, missing attachments, and incorrectly rendered macros. Re-upload images by dragging them from the exported attachments folder into the Notion page.

Method 2: Direct HTML Import Using Notion’s Confluence Importer

Notion offers a dedicated import option for Confluence that works directly with HTML exports from Confluence Cloud.

1. Export your Confluence space as HTML
   Follow the same steps as in Method 1 to export the space as HTML. You will receive a ZIP file.
2. Open Notion and go to Import
   Click Settings & Members in the left sidebar. Then click Import under the Workspace section.
3. Select Confluence from the list of import sources
   Notion shows a list of supported platforms. Click Confluence. A file picker dialog opens.
4. Upload the ZIP file
   Select the ZIP file you exported from Confluence. Notion will process the file and create a new page for each Confluence page in the export.
5. Check the imported pages
   Notion creates a top-level page named after the Confluence space. Inside, each Confluence page becomes a sub-page. Review the formatting and fix any broken elements.

What to Do When the Import Produces Errors or Missing Content

Tables appear as plain text instead of Notion tables

Confluence tables with merged cells or complex formatting may not convert correctly. After the import, manually recreate the table in Notion. Select the plain text, copy it, then create a new Notion table and paste the text into the first cell. Notion will not auto-detect table structure from pasted text.

Images and attachments are missing after import

Confluence exports images as separate files in an attachments folder. Notion does not automatically link these files. After the import, drag each image file from the attachments folder into the correct position in the Notion page. For file attachments, upload them using the Upload button in Notion’s file block.

Code blocks lose syntax highlighting

Confluence uses different code block syntax than Notion. After import, select any code block, click the language dropdown in the block toolbar, and re-select the correct programming language. Notion will apply syntax highlighting based on the language you choose.

User mentions and inline comments are lost

Confluence user mentions and inline comments are not supported in Notion’s import. The text of the mention remains, but the link to the user profile is removed. You can manually re-create mentions by typing @ followed by the person’s name in Notion if they are members of your workspace.

Confluence Export Format Comparison for Notion Import

Export Format	What Preserves Well	What Breaks or Is Lost
HTML (ZIP)	Headings, lists, tables, code blocks, images (as separate files)	User mentions, inline comments, page macros, embedded diagrams
PDF	Visual layout, text formatting, images	Editable blocks, hyperlinks, code blocks (rendered as images)
Markdown (via Pandoc)	Headings, lists, code blocks, inline formatting, tables (simple)	Complex tables with merged cells, images (paths only), page macros

You can now transfer Confluence pages into Notion using either the Markdown export method or the direct HTML import. For simple pages, the Markdown route gives you the cleanest result. For complex pages with many attachments and macros, the HTML import preserves more structure. After importing, always check tables and code blocks manually. A useful next step is to explore Notion’s database views — you can convert imported pages into a database by adding properties like status, date, and assignee.