View all guides

Document conversion

Three ways to move a Confluence page to Markdown

A copied Confluence page can keep its headings but flatten a table or leave attachments on an internal URL. Start with paste. If the structure is missing, switch to Quick Send or an HTML export.

ResultA checked UTF-8 .md file with headings, lists, tables, and usable links
01

1. Copy only the body you need

Select from the page title through the last useful paragraph. Navigation, comments, and related-page cards rarely belong in the archive.

Paste into MD.SAVE. If headings become #, lists become -, and the table becomes pipe-separated rows, Confluence supplied structured clipboard HTML and the fastest route worked.

  • Check table rows and columns in Preview
  • Confirm the document starts with one H1
  • Test internal attachments and relative links outside Confluence
02

2. Switch to Quick Send when paste arrives as plain text

If every heading becomes ordinary text or a table collapses into tab-separated sentences, repeating the paste will not add structure. Use MD.SAVE Quick Send on the selected region. It reads the rendered headings, lists, links, and tables after you explicitly run it in the current tab.

03

3. Compare HTML export for a larger archive

For many pages or when you need to keep an exported source, open a UTF-8 HTML file up to 2 MB in MD.SAVE. Macros, merged cells, collapsed regions, and iframes do not have one-to-one Markdown equivalents; rewrite their meaning as prose or a simpler table.

04

4. Review four failure points before saving

  • Columns that came from merged cells
  • Image descriptions that are only filenames
  • Protected links in a document meant for external readers
  • Empty links, skipped heading levels, and unclosed code fences
Useful filenamesproject-decisions-2026-08.mdproduct-operations-v2.md
05

Privacy and limits

Paste and HTML conversion run in the current browser. The links and image URLs in the source can still reveal an organization, space key, or internal path, so review them before external sharing.