Output appears here...How to use
01
Paste your HTML
Put the markup in the HTML pane on the left. The Try sample button loads a small snippet with a heading, a list, and a link to demonstrate the mapping.
02
Click Convert to Markdown
Turndown walks the elements and writes the equivalent Markdown into the right pane, using hash headings, fenced code, and hyphen bullets throughout.
03
Save the Markdown
Copy the result into a .md file for your static site, your docs repo, or wherever the content is headed next.
Why HTML to Markdown
- Convert any HTML to clean Markdown via turndown.
- ATX headings (# H1) and fenced code blocks.
- Strips most styling but preserves structure.
Common questions
What Markdown style does the converted output use?
ATX headings, so an h2 becomes two hash marks rather than underlined text, fenced code blocks with backticks, and hyphens for bullet lists. Those defaults match what GitHub, most static site generators, and most editors expect, so files drop into an existing repo without restyling.
Do tables convert into Markdown pipes?
No, that's a known limit of the core converter: table content comes through as plain text lines without the pipe syntax. If your source relies on tables, plan to rebuild them by hand or keep those sections as raw HTML inside the Markdown file.
Can a full webpage be converted to Markdown, navigation and all?
It'll convert whatever you paste, but you'll get cleaner results by copying just the article or body markup. Menus, footers, and cookie banners turn into link lists that pollute the document. Trim the source first and html to markdown online conversion gets dramatically more useful.
What happens to classes, ids, and inline styles in the Markdown?
They're dropped, and that's usually the point. Markdown has no way to express them, so the conversion keeps the semantic layer, meaning headings, emphasis, links, and images with their alt text, and discards presentation. If a div carried meaning only through its class, that meaning won't survive.
Do I need pandoc, or can I convert html to md online here?
This page covers the everyday case: paste markup, get Markdown, nothing to install. Pandoc earns its place for batch jobs and exotic formats, but to convert html to md online for a handful of pages, the button here is faster than setting anything up.
Why did my nested list convert to Markdown badly?
Deeply nested or invalid list markup is the most common trouble spot, especially CMS exports where li elements were never closed. Run the source through the HTML Beautifier first to spot the broken nesting, fix it, then convert. Clean input produces faithful lists.
How does the html to markdown conversion handle a full snippet?
Paste your markup and click Convert to Markdown; Turndown walks the elements and writes ATX headings, fenced code blocks, and hyphen bullets. To convert html code to markdown it keeps the structure, headings, links, lists, and images, and drops the styling. As an html text to markdown parser it reads the tags, not the CSS.
Can I keep some raw HTML in the Markdown output?
Yes. Markdown allows inline HTML, so if a tag has no Markdown equivalent it can stay as html in markdown and still render. As a markdown converter this page focuses on the clean mappings and leaves anything it can't express as-is, which is handy for an embedded iframe or a video tag.
Does this also convert Markdown to HTML?
Not this page; it goes HTML to Markdown. To convert markdown to html, use the Markdown to HTML tool, which renders a live preview and shows the generated tags. The two pages are a matched pair for round-tripping content between the formats.
Is this a text to markdown converter for plain writing?
It's really an HTML in, Markdown out tool, so a plain text to markdown converter isn't quite what it is; there are no headings or links to detect in unstructured text. If your content is already HTML, though, this turns it into clean Markdown in one click. Wrap plain text in basic tags first if you want structure preserved.