HTML to Markdown Converter

Moving a web page, a CMS post or a Word-exported HTML file into a README, a wiki, a static-site generator or a notes app means rewriting it as Markdown. This converter does that from pasted HTML or an .html file. Headings, paragraphs, bold and italic, links, images, nested lists, blockquotes, GitHub-style tables with alignment and fenced code blocks with their language come out as clean Markdown. Scripts, styles and form controls are dropped. Everything runs in your browser.

How to use this tool

1. Paste the HTML, or choose an .html file.
2. Pick the heading style, bullet marker, link style, line-break style and code fence.
3. Copy the Markdown, or download it as a .md file.

Formula

h1–h6 → # … ###### · strong/b → text between double asterisks · em/i → _text_ · a → [text](url) · img →  · ul/ol → - item / 1. item (nested by 2–3 spaces) · table → | a | b | with | --- | · pre code → `lang

The HTML is parsed by the browser (DOMParser), so broken markup is repaired the way a browser would. Whitespace collapses as on a web page, except inside pre. Characters that would otherwise be read as Markdown (* _ ` [ ] and a # or 1. at the start of a line) are escaped with a backslash. A code fence is made longer when the code itself contains one. Pipes in table cells are escaped, and merged cells are flattened because Markdown tables cannot merge cells. sup, sub, u and mark are kept as inline HTML, which GitHub and most renderers accept.

Example

The default HTML becomes a level-1 heading line (# Release notes), then a paragraph in which 2.4 is wrapped in double asterisks, dark mode in underscores and the issue link written as [issue #42](https://example.com/issues/42). A two-level bullet list follows, then a table whose Size column is right-aligned (the separator row reads | --- | ---: |) and a fenced code block marked bash that holds npm install app@2.4.