What HTML elements are supported?

The converter supports headings (h1-h6), paragraphs, bold, italic, strikethrough, links, images, ordered and unordered lists, tables, code blocks (inline and fenced), blockquotes, and horizontal rules.

Does it preserve code syntax highlighting?

Yes! If your HTML code blocks have language classes (like class="language-javascript"), the converter will include the language hint in the markdown fenced code block for syntax highlighting.

How are nested lists handled?

The converter processes list items at the top level. For deeply nested lists, you may need to manually adjust the indentation in the output.

What happens to scripts and styles?

Script tags, style tags, and HTML comments are automatically removed during conversion to produce clean markdown output.

Can I convert HTML with special characters?

Yes, the converter automatically decodes common HTML entities like &, <, >, ", , and numeric entities like ' and '.

What is the "preserve line breaks" option?

When enabled, HTML tags are converted to markdown soft line breaks (two trailing spaces). When disabled, they become regular newlines.

HTML to Markdown Converter

Convert HTML code to clean Markdown format instantly. Supports headings, lists, tables, code blocks, links, images, and more.

HTML Input

Options

Preserve line breaks (soft wraps)

Include code language hints

Bullet Style

Markdown Output

Paste HTML to see the markdown output

Converts headings, lists, links, images, tables, code blocks, and more

HTML to Markdown Reference

Element	HTML	Markdown
Heading 1	<h1>Title</h1>	# Title
Heading 2	<h2>Title</h2>	## Title
Bold	<strong>text</strong>	text
Italic	<em>text</em>	text
Link	<a href="url">text</a>	[text](url)
Image	<img src="url" alt="alt">	![alt](url)
Unordered List	<ul><li>item</li></ul>	- item
Ordered List	<ol><li>item</li></ol>	1. item
Blockquote	<blockquote>text</blockquote>	> text
Code	<code>code</code>	`code`
Horizontal Rule	<hr>	---

Features

Full Element Support

Code Block Detection

Table Conversion

Customizable Options

Entity Decoding

Clean Output

Common Use Cases

Blog Migration

Convert HTML blog posts to markdown when migrating to static site generators like Next.js, Gatsby, or Hugo.

Documentation

Transform HTML documentation into markdown for GitHub READMEs, wikis, or documentation sites.

Content Repurposing

Convert web content to markdown for use in note-taking apps like Obsidian, Notion, or Roam.

CMS Migration

Export content from HTML-based CMS systems to markdown-based platforms.

Frequently Asked Questions