Which HTML elements are supported?

Headings (h1–h6), paragraphs, links, images, lists, blockquotes, code blocks, inline code, emphasis, strong, tables, and horizontal rules. Unknown elements are stripped.

What about inline styles?

Dropped — markdown doesn't support arbitrary CSS. If your HTML relies on inline styles, consider outputting MDX or keeping HTML.

Will it handle a full web page?

It will, but the output will include navigation and unrelated content. For 'extract the article', paste only the main content or use a reader-mode extraction first.

Does it escape special characters?

Yes — asterisks, underscores, and other markdown-significant characters in your HTML text are escaped with backslashes so they render as text rather than formatting.

Can I convert HTML email templates to Markdown?

Partially. HTML email is heavily reliant on tables for layout (still!), inline styles, and color-coded buttons — none of which translate cleanly to Markdown. The text content extracts well; the layout doesn't. For migrating an email-marketing template to a Markdown-based platform (Substack, Beehiiv), expect to redesign the visual structure manually. Markdown is content-focused; email templates are design-focused. The two are fundamentally different formats.

What if my HTML has nested tables?

Markdown's table syntax (pipes and dashes) doesn't support nested tables. The converter will flatten nested tables into separate sequential tables, or convert deeply-nested ones to plain text. For documents with complex table layouts, consider keeping HTML. For typical content with single-level tables (comparison tables, schedules, simple data), the conversion is clean. GitHub-Flavored Markdown supports column alignment (:--- :---: ---:) which is preserved.

File & Format Converters · Free tool

HTML to Markdown

Paste HTML and get clean Markdown with preserved headings, lists, links, and code blocks. Ideal for migrating blogs instantly with this free, no-sign-up online tool.

Updated June 2026

HTML input

Markdown output

Browser APIs not available — try reloading.

Supports headings (h1–h6), bold, italic, links, images, ordered and unordered lists, blockquotes, inline code, code blocks, and horizontal rules. Tables and complex nested HTML may need manual cleanup.

Found this useful?Email Buy Me a Coffee

What it does

A free HTML to Markdown converter. Paste any HTML — a blog export, a rich-text editor dump, an AI-generated page — and get clean Markdown out. Handles headings, inline formatting, links, images, lists, blockquotes, code blocks, and horizontal rules. Script, style, and tracking tags are stripped automatically.

Useful for migrating a WordPress blog to a static site, dropping rich content into a Markdown-first CMS, cleaning up Notion or Google Docs exports, or converting AI-generated HTML back into something Git-friendly. The counterpart tool is our Markdown to HTML converter.

Embed this tool on your siteShow snippet

Paste this snippet into any page. Loads on-demand (lazy), no tracking scripts, and sized to most dashboards. Replace the height to fit your layout.

<iframe src="https://freetoolarena.com/embed/html-to-markdown" width="100%" height="720" frameborder="0" loading="lazy" title="HTML to Markdown" style="border:1px solid #e2e8f0;border-radius:12px;max-width:720px;"></iframe>

Embed docs →

How to use it

Paste or type HTML into the input box.
Read the Markdown output instantly in the second box.
Copy the result with one click.
Tables and heavily nested HTML may need a small manual cleanup.

When to use this tool

Migrating WordPress / Squarespace blog content to a Markdown-based static site.
Cleaning up Notion or Google Docs HTML exports for a Git-friendly format.
Converting AI-generated HTML responses back to Markdown for repository commits.
Stripping inline styles and scripts from copy-pasted rich text.

When not to use it

Email HTML templates with table-based layout — Markdown can’t represent layout structures.
Heavily styled documents — Markdown is content-focused, lossy for visual design.
Documents with custom HTML elements or web components — those will be stripped.

Common use cases

WordPress blog migration: 200 posts converted from HTML to Markdown for Hugo / Astro.
Notion → Obsidian migration: bulk-convert page HTML to clean Markdown.
Cleaning up Google Docs HTML pasted into a developer-tool issue tracker.
Converting a static-site rendered HTML page back to its Markdown source for editing.

Frequently asked questions

Which HTML elements are supported?: Headings (h1–h6), paragraphs, links, images, lists, blockquotes, code blocks, inline code, emphasis, strong, tables, and horizontal rules. Unknown elements are stripped.
What about inline styles?: Dropped — markdown doesn't support arbitrary CSS. If your HTML relies on inline styles, consider outputting MDX or keeping HTML.
Will it handle a full web page?: It will, but the output will include navigation and unrelated content. For 'extract the article', paste only the main content or use a reader-mode extraction first.
Does it escape special characters?: Yes — asterisks, underscores, and other markdown-significant characters in your HTML text are escaped with backslashes so they render as text rather than formatting.
Can I convert HTML email templates to Markdown?: Partially. HTML email is heavily reliant on tables for layout (still!), inline styles, and color-coded buttons — none of which translate cleanly to Markdown. The text content extracts well; the layout doesn't. For migrating an email-marketing template to a Markdown-based platform (Substack, Beehiiv), expect to redesign the visual structure manually. Markdown is content-focused; email templates are design-focused. The two are fundamentally different formats.
What if my HTML has nested tables?: Markdown's table syntax (pipes and dashes) doesn't support nested tables. The converter will flatten nested tables into separate sequential tables, or convert deeply-nested ones to plain text. For documents with complex table layouts, consider keeping HTML. For typical content with single-level tables (comparison tables, schedules, simple data), the conversion is clean. GitHub-Flavored Markdown supports column alignment (:--- :---: ---:) which is preserved.

Learn more

Explore more file & format converters tools

100% in-browserNo downloadsNo sign-upMalware-freeHow we keep this safe →