Paste to Markdown

When you copy formatted text and paste it into this converter, your browser strips the HTML formatting and gives the converter only the plain text. So paste-to-Markdown works on the visible text only — it cannot see the HTML headings, bold tags, or table cells that were in the original document.

If you want to preserve HTML structure during conversion (especially headings, bold, italic, links), use the HTML to Markdown tool instead — paste the actual HTML source rather than the rendered text.

In practice: for casual conversions where you just want the text in Markdown form, paste-to-Markdown is faster. For documentation conversions where you need accurate headings and links, HTML to Markdown is more accurate.

The converter uses three signals to identify headings in plain text:

(1) ALL-CAPS short lines: A line under 80 characters in all uppercase letters is treated as a section heading. "GETTING STARTED" becomes "## Getting Started".

(2) Lines that look like titles: Single-line statements that end without punctuation, surrounded by blank lines, are likely headings. The converter is conservative here to avoid false positives.

(3) Numbered section headers: Lines like "1. Introduction" or "Section 2: Architecture" at the start of a logical block are treated as section markers, not list items.

For documents where the headings are NOT visually distinct in the source, the converter cannot guess where sections begin. Add ## headings by hand after conversion in those cases.

Two methods work, depending on how much structure you need to preserve:

Method 1 (fast): In Notion, select the blocks you want, click the "..." menu, choose "Copy as plain text", paste here. The converter detects headings and bullets from the visible structure.

Method 2 (more accurate): In Notion, click the "..." menu at the top of the page, choose "Export", select "Markdown & CSV", and download. You will get a .zip with a .md file inside that already has Markdown syntax — no conversion needed.

For one-off conversions of a single page, Method 1 is faster. For migrating many pages out of Notion (e.g., to a new docs site), Method 2 is far more accurate because it preserves Notion's internal block structure.

Need to convert a different source format? We have dedicated tools for each:

• HTML to Markdown
• PDF to Markdown
• DOCX to Markdown
• JSON to Markdown
• CSV to Markdown
• Webpage to Markdown
• Google Docs to Markdown
• Notion to Markdown
• XML to Markdown
• RTF to Markdown

Or use the multi-format Markdown Converter hub to switch between modes in one tool.