HTML to Markdown Converter

Convert HTML into clean Markdown instantly in your browser, ready to paste anywhere. Turn a blog post snippet, a list with links, or documentation pulled from a help center into well-formatted Markdown, including code blocks and nested headings.

Markdown output

Usage examples

Converting a blog post snippet

Copied a section from a CMS or web page with headings, bold text, and links? Paste the HTML in and get clean Markdown ready for a static site or notes app.

Converting a quote with a nested heading

Have a '<blockquote>' pulled from an article, maybe with a heading or emphasis inside it? Paste it in to get a Markdown blockquote ('>') with the inner formatting preserved.

Converting a list with links

Got an '<ul>' full of '<a>' links? Paste it in to get a Markdown bullet list with proper '[text](url)' link syntax, ready to reuse.

Converting documentation pulled from a help center

Scraped an article with nested headings, inline code, and a couple of '<img>' screenshots? Paste the whole thing in to get Markdown with ATX-style '#' headings, backtick-wrapped inline code, and '![alt](src)' image syntax ready for a README or wiki page.

Converting a code sample with a language-specific block

Have a '<pre><code class="language-js">' block copied from a tutorial site? Paste it in to get a fenced Markdown code block, so you can confirm the content survives the conversion before dropping it into your own docs.

Frequently asked questions

Is my HTML uploaded to a server?

No. The conversion runs entirely in your browser using the Turndown library. The HTML you paste is never sent anywhere.

Which HTML elements convert well?

Headings, paragraphs, bold/italic text, links, images, simple lists, blockquotes, and code blocks all convert cleanly to their standard Markdown equivalents.

Which HTML elements convert poorly?

Tables are the biggest gap: this tool doesn't produce Markdown pipe-table syntax, so a '<table>' is flattened into plain text lines instead. Inline styles, custom CSS classes, embedded scripts, and layout-heavy markup (like multi-column divs) also don't have a clean Markdown equivalent and are simplified or dropped, since Markdown has no concept of visual styling or layout.

Why does my code block use triple backticks instead of indentation?

The converter is configured to produce fenced code blocks (using ``` instead of 4-space indentation) because fenced blocks are easier to read, support language hints, and are the format most Markdown renderers and editors expect today.

Is my input saved anywhere?

Only in your browser's local storage (localStorage), so your HTML is still there if you come back later. It's never shared with a server or synced across devices, and you can clear it anytime with the Clear button.

Why do bullet lists use '-' and italics use single asterisks instead of underscores?

This tool configures Turndown to use '-' for bullet points and '*' for emphasis rather than its defaults ('*' and '_'), because that combination matches the style most commonly seen in GitHub Flavored Markdown and avoids ambiguity when a word contains an underscore.

Can I convert an entire HTML page, including '<html>' and '<body>' tags?

Yes. You can paste a full document and the converter will extract and convert the meaningful content, but it's usually cleaner to paste just the relevant fragment (like a single '<article>' or '<div>') so you don't end up converting navigation bars, footers, or scripts that happened to be in the page.