HTML to Markdown

About HTML to Markdown

This does the reverse of a Markdown converter: it takes HTML and produces clean, readable Markdown. It's the tool for lifting content out of a web page or rich editor and into a Markdown-based system — writing a README from an HTML snippet, moving CMS content into a static-site or docs repo, or stripping heavy HTML down to simple, portable formatting you can version-control and read as plain text.

How it works

The HTML is converted by Turndown, a dedicated HTML-to-Markdown engine, configured for clean output: ATX-style headings (#, ##), fenced code blocks (```), and dash bullets (-) for lists. It walks the HTML structure and maps each element to its Markdown equivalent — headings, paragraphs, bold/italic, links, images, lists, blockquotes, code and horizontal rules — producing tidy Markdown that reads well as plain text.

Assumptions and behaviour

• Output uses ATX headings (## Heading), fenced code blocks, and - as the bullet marker, for consistent, modern Markdown.
• Common structural and inline elements are mapped to their Markdown counterparts.
• Elements that have no Markdown equivalent are handled gracefully — Turndown keeps meaningful content and drops purely presentational wrappers.
• Conversion updates live as you paste or edit.

Limitations

• Markdown is simpler than HTML, so some things don't survive. Styling (colours, fonts, CSS classes), complex tables with merged cells, nested layout <div>s, and scripts have no Markdown form and are simplified or dropped.
• Complex or malformed HTML may produce Markdown that needs a little cleanup.
• It converts the markup you paste in; it doesn't fetch a page from a URL or resolve relative links and image paths.
• The result captures structure and text, not exact visual appearance — that's the point of Markdown, but worth expecting.

Privacy

Conversion runs entirely in your browser. Your HTML and the resulting Markdown never leave your device.