HTML to Markdown Converter — Free Online

When you need HTML to Markdown

Two big reasons: migration and authoring. Migration happens when you're moving content from an HTML-based CMS (WordPress, Drupal, a legacy site) to a Markdown-based system (GitHub, Hugo, Jekyll, Notion, Obsidian). Authoring happens when you've copied formatted content from somewhere (a webpage, a Google Doc, an email) and want to paste it into a Markdown editor cleanly — without the cruft of <span style="…"> tags everywhere.

This converter uses turndown.js — the most widely-used HTML-to-Markdown library, used by Hugo, Ghost, and many other tools — to produce clean GitHub-flavored Markdown output.

What gets converted

• Headings — <h1> through <h6> become # through ######.
• Paragraphs and line breaks.
• Bold and italic — <strong> → **text**; <em> → *text*.
• Links — [text](url).
• Images — ![alt](src).
• Code — inline `code` and fenced ```code blocks```.
• Lists — both ordered and unordered, nested supported.
• Blockquotes — > quoted.
• Tables — GFM table syntax.
• Horizontal rules.

Common HTML-to-Markdown scenarios

• Moving WordPress posts to a static site generator like Hugo or Jekyll.
• Pasting web content into Obsidian / Notion for clean import.
• Converting MailChimp HTML newsletters back to Markdown for editing.
• Cleaning up Google Doc HTML exports for use as documentation.
• Building a corpus of plain-text content from scraped HTML pages.
• Migrating knowledge-base articles from Zendesk / Confluence to GitHub wikis.

Tips

• Inline styles and class attributes get dropped — Markdown doesn't carry CSS information. If you depend on inline styles, you'll need to recreate them in CSS afterwards.
• For complex tables, GFM table syntax doesn't support cell-merging. Tables with rowspan/colspan need manual fixing.
• Embedded videos and iframes are stripped — they have no Markdown equivalent. Add them back manually with appropriate syntax for your destination platform.
• For round-trip authoring (Markdown → HTML → edit → back to Markdown), expect minor formatting drift on each pass.

FAQs

Related tools