Free Online HTML to Markdown Converter
Convert HTML into clean Markdown for docs and README files.
Turndown converts the document structure rather than copying its formatting. Script, style, iframe, and template elements are removed so they do not leak into the Markdown output.
About the HTML to Markdown Converter
Markdown is a lightweight formatting language used in README files, documentation sites, issue trackers, note apps, and static site generators. HTML is the language browsers render. When you move content from a website, CMS, or email template into Markdown, you usually want the structure preserved without the extra markup. This converter walks the HTML tree and produces clean Markdown for headings, paragraphs, lists, links, emphasis, blockquotes, and code.
The conversion is powered by Turndown, a well-tested HTML-to-Markdown library that runs entirely in your
browser. Three options let you match the conventions of your destination: ATX headings use leading
# characters while Setext headings underline the text with equals signs or dashes. Links can be
written inline next to the text or collected as references at the end of the document. Code blocks can use
fenced triple backticks or indented lines. The result updates as you type, and the word count helps you judge
the length of the converted content.
What is preserved
- Headings:
h1throughh6become Markdown headings. - Emphasis: bold and italic tags become
**and*markers. - Lists: ordered and unordered lists keep their nesting and numbering.
- Links: anchor text and URLs are preserved, with an inline or reference style.
- Code: inline code and preformatted blocks keep their content.
- Blockquotes and rules: quoted sections and horizontal rules are converted.
Not every HTML feature has a natural Markdown equivalent. Tables, embedded videos, custom components, and complex layouts may be simplified or dropped. Scripts, styles, iframes, and templates are intentionally removed for safety and readability. If you need a table, convert it separately or add a Markdown table extension after the conversion. Always review the output before publishing, especially if the source contained interactive elements.
How to convert HTML
- Paste HTML into the left editor, or load the sample.
- Choose heading, link, and code block styles.
- Review the Markdown output on the right.
- Copy it or download it as a
.mdfile.
Frequently asked questions
Does it support Markdown tables?
Turndown's core conversion does not include GitHub-flavoured table syntax. Table content may be flattened into text. Use a Turndown plugin or convert tables manually if you need pipe tables.
Why are inline styles lost?
Markdown describes structure and emphasis, not visual styling. A span with a custom color or font has no equivalent marker, so only its text is kept. Use the destination's stylesheet for visual design.
Is the HTML executed while converting?
No. The HTML is parsed as data and walked by the converter. Scripts and styles are removed, and nothing is inserted into the visible page.