About HTML to Markdown
This tool converts HTML into clean Markdown. Paste HTML — or content copied from a web page — and get tidy Markdown with headings, lists, links, bold, code and more. It is perfect for moving content into README files, static-site generators, notes apps and anywhere Markdown is preferred. It runs entirely in your browser.
How HTML to Markdown works
How to convert HTML to Markdown
- Paste your HTML in the box above.
- The Markdown output appears instantly.
- Copy it into your README, notes app or static-site content.
Clean, readable output
The converter maps HTML elements to their Markdown equivalents — headings, lists, links, images, bold and italics, blockquotes and code — and strips unnecessary markup so the result is easy to read and edit.
Why convert HTML to Markdown
Markdown is simpler to store, diff and edit than HTML. Converting lets you bring web content into Markdown-based workflows like GitHub, documentation sites and note apps.
HTML to Markdown reference
| HTML | Markdown |
|---|---|
<h1>…</h1> | # … |
<strong> | **bold** |
<em> | *italic* |
<a href> | [text](url) |
<li> | - item |
Common uses
- Move web content into Markdown
- Create README files from HTML
- Convert pages for static-site generators
- Clean up messy pasted HTML
- Migrate content to notes apps
- Turn rich text into Markdown
- Prepare docs for GitHub
- Simplify HTML for editing
Frequently asked questions
How do I convert HTML to Markdown?
Paste the HTML and the Markdown appears instantly, ready to copy.
Does it keep links and lists?
Yes — links, images, lists, headings, emphasis and code are converted to Markdown.
Will it remove extra markup?
Yes — unnecessary tags and attributes are stripped for clean Markdown.
Is my content uploaded?
No — conversion happens entirely in your browser.
Can I go the other way?
Yes — use the Markdown to HTML tool for the reverse.
Does it handle tables?
Yes — HTML tables are converted to Markdown tables where possible.
Is it free?
Yes — completely free with no sign-up.
Can I paste a whole web page?
Yes — paste the page HTML and it will be converted to Markdown.