Will all HTML elements convert cleanly?

Common ones yes: headings (h1-h6), paragraphs (p), bold/italic (strong/em), links (a), lists (ul/ol/li), images (img), code (code/pre), and tables. Less common elements (semantic HTML5 like article/section, advanced CSS-styled content) may convert to plain text or be approximated. Inline styles are stripped.

What happens to CSS styling?

Markdown has no styling — only structural formatting. CSS is stripped during conversion. Bold (visually applied via CSS like font-weight:bold) won't become **bold** in Markdown unless the HTML uses semantic or tags. Pre-process HTML to use semantic tags before converting for best results.

Does it preserve images?

Yes. becomes ![alt](src) in Markdown. The image source URL and alt text are preserved. For local images that should be co-located with the Markdown file, you'll need to download images and update paths separately — converters don't fetch remote images.

How are tables handled?

HTML tables convert to GFM-style Markdown tables (|Col1|Col2|\n|---|---|\n). Complex tables (with rowspan, colspan, nested tables) can't be fully represented in Markdown — these may produce simplified output or HTML embedded in Markdown. Simple data tables convert cleanly.

What about embedded videos and iframes?

Markdown has no syntax for videos or iframes. Most converters either preserve them as raw HTML in the Markdown (CommonMark allows this) or strip them entirely. If you need to preserve video embeds, expect to retain HTML markup in the converted Markdown.

Will the conversion be lossless?

Approximately for content; not exactly for styling. The Markdown will represent the same text and structural information as the HTML. CSS styling, custom attributes, and HTML5-specific features won't survive. For lossless conversion, store HTML as HTML rather than going through Markdown.

Is the data sent to a server?

No. All conversion happens in your browser. Your HTML never leaves your device — safe for confidential email templates, internal pages, or any HTML containing private content.

HTML to Markdown

Convert HTML to Markdown format online instantly. Free HTML to Markdown converter preserving headings, links, images, and lists.

Code Converters Web & SEO

Instant results

HTML Input

Markdown Output

Markdown will appear here...

About HTML to Markdown

Convert HTML to clean Markdown syntax. Supports headings, links, images, lists, code blocks, blockquotes, and more. Perfect for converting web content to documentation.

How to Use HTML to Markdown

Paste your HTML

Paste HTML content into the input editor. Full pages, fragments, or content from web scrapes all work.

View Markdown output

The Markdown equivalent appears instantly: headings (h1-h6), paragraphs, bold/italic, links, lists, images, and tables convert cleanly.

Customize options

Choose Markdown flavor (CommonMark, GFM), how to handle complex elements (preserve as raw HTML or strip), and image handling.

Copy or save

Click Copy to use the Markdown elsewhere, or Download as .md file. Use for migrations between CMSes, blog imports, or backing up web content in portable form.

When to Use HTML to Markdown

Migrating CMS content to Markdown-based platforms

When moving from WordPress, Drupal, Wix to a static site generator (Jekyll, Hugo, Astro) or a Markdown-based CMS (Notion, Obsidian, Ghost), convert exported HTML to Markdown. The portable format works everywhere and travels with you across platforms.

Extracting article content from web pages

When archiving articles, blog posts, or documentation from the web, converting the relevant HTML to Markdown produces a clean, portable backup. Strip out ads and navigation HTML first; convert the article content to Markdown for storage in any text-friendly system.

Processing email content

Newsletter HTML can be converted to Markdown for archival, full-text search indexing, or AI processing. Markdown's structural simplicity makes it easier to parse and extract content from than complex HTML email layouts (which often have tables, inline CSS, conditional comments).

Generating Markdown documentation from HTML

If you have HTML documentation (legacy docs, exported from a wiki, generated by a tool that only outputs HTML), converting to Markdown lets you maintain it in version control alongside code. Edit Markdown, regenerate HTML when needed via static site builds.

HTML to Markdown Examples

Basic HTML to Markdown

Input

<h1>Title</h1><p>This is <strong>bold</strong> text.</p>

Output

# Title\n\nThis is **bold** text.

Headings (h1-h6) become # syntax with appropriate level. <strong> becomes **bold**, <em> becomes *italic*. Paragraph breaks become blank lines. Output is clean Markdown ready for any Markdown-aware tool.

Lists conversion

Input

<ul><li>First</li><li>Second</li><li>Third</li></ul>

Output

- First\n- Second\n- Third

Unordered <ul> lists become - prefixed Markdown. Ordered <ol> lists become 1. 2. 3. numbered lists. Nested lists are indented appropriately. List items containing complex elements (paragraphs, sublists) are properly formatted.

Links and images

Input

<a href="https://example.com">Click</a><img src="logo.png" alt="Logo">

Output

[Click](https://example.com)![Logo](logo.png)

Links become [text](url); images become ![alt](url). Image dimensions and CSS styling don't translate — Markdown is structural only. For sized images, you may need to add HTML <img> tags inline (CommonMark allows this) or use platform-specific extensions.

Tips & Best Practices for HTML to Markdown

1.Pre-process HTML to use semantic tags. <strong> converts to **bold**; <span style="font-weight:bold"> doesn't. Convert non-semantic styled elements to semantic ones first using a tool like Prettier or beautifying with structure-aware options.
2.Strip navigation, ads, and chrome before converting. Markdown converters faithfully convert all HTML they receive — pre-processing with a 'reader mode' style cleaner (like Mozilla Readability) produces cleaner Markdown.
3.For complex tables (rowspan, colspan, nested tables), Markdown can't represent them fully. Decide: simplify to flat tables, retain HTML for those tables (CommonMark allows mixed Markdown/HTML), or restructure data presentation.
4.Verify code blocks survive conversion. <code> within <pre> should become a fenced code block (```). Verify language detection if your HTML has class="language-X" hints.
5.After conversion, manually review for missing line breaks (some converters drop them), incorrectly formatted nested lists, lost table styling, and dropped attributes that mattered. Most converters do 90% of the work; the last 10% is polish.
6.Tools: Turndown (most popular JS HTML→MD), pandoc (most powerful, supports many formats), html-to-text (when you don't need Markdown structure). Choose based on your needs.

Frequently Asked Questions

Markdown is portable across many platforms (GitHub, Notion, Obsidian, blog platforms, documentation generators). Converting existing HTML content (from CMS exports, web scrapes, email templates) to Markdown lets you migrate content into modern writing tools, version control systems, or static site generators that prefer Markdown.

HTML to Markdown

About HTML to Markdown

How to Use HTML to Markdown

Paste your HTML

View Markdown output

Customize options

Copy or save

When to Use HTML to Markdown

Migrating CMS content to Markdown-based platforms

Extracting article content from web pages

Processing email content

Generating Markdown documentation from HTML

HTML to Markdown Examples

Basic HTML to Markdown

Lists conversion

Links and images

Tips & Best Practices for HTML to Markdown

Frequently Asked Questions

Related Tools

Markdown to HTML

HTML to JSX

SCSS to CSS

JSON to XML

XML to JSON

JSON to YAML