HTML to markdown converter
Updated
Paste HTML source, or simply copy content from a web page, Google Doc, or Notion and paste it here — the rich-text clipboard arrives as HTML and is converted to GitHub-flavored markdown on the spot. Tables, code blocks, nested lists, task lists, and strikethrough all survive. Nothing is uploaded.
790 bytes of HTML → 0 words, 0 characters of markdown. Everything runs in your browser.
How does HTML become markdown?
The converter walks the HTML document tree and replaces each element with its markdown equivalent: <h2> becomes ## , <strong> becomes **bold**, <ul><li> becomes a bulleted list, and <pre><code class="language-js"> becomes a fenced code block tagged with its language. Elements that markdown cannot express — spans with inline styles, divs, forms — are unwrapped so their text is kept and the wrapper is dropped. The result is the same GFM that GitHub renders, so it pastes straight into a README or a shared markdown link.
Which option should I pick for headings and bullets?
ATX headings (# Title) are the modern default and the only style that supports six levels; setext headings underline a title with === or --- and only reach two levels. For bullets, - is the most common marker in open-source projects and what most linters expect. If you need the output to match an existing document, run it through the markdown formatter with that document's settings.
What about the other direction?
The markdown to HTML converter turns markdown back into a clean fragment or a complete styled document. For Word files use the markdown to Word converter, which also accepts pasted Word content, and the PDF to markdown converter handles PDFs.
Does the converter handle tables?
Yes. HTML tables become GFM pipe tables with a header row and alignment separator. Merged cells (colspan/rowspan) have no markdown equivalent, so their contents are flattened into ordinary cells.
Can I paste a whole web page?
Yes. Select the page, copy, and paste into the source box. With "Strip scripts, styles, nav" on, script and style tags, navigation, headers, footers, and iframes are removed before conversion so you get the article, not the chrome.
What is the difference between inline and reference links?
Inline links put the URL right after the text: [text](url). Reference style puts a short label in the text and lists every URL at the bottom of the document, which keeps long paragraphs readable and is common in READMEs.
Why do some pasted documents lose their headings?
Word processors and some sites express headings as styled paragraphs (a <p> with a big font) rather than <h1>–<h6> tags. The converter only sees the tags, so those become plain paragraphs. Add the # marks by hand or use the markdown formatter afterwards.
Is the conversion done in my browser?
Yes. The page loads the turndown library on demand and runs it locally; the HTML never leaves your machine, and there is no size limit beyond what your browser can hold.