Will tables convert correctly?

Standard HTML table, tr, th, and td structures convert to pipe-delimited Markdown tables, matching the GitHub-flavored Markdown table format.

What happens to inline styles or CSS classes in my HTML?

Styling information like inline style attributes and CSS classes is dropped — Markdown has no concept of arbitrary styling, so only the semantic structure (what’s a heading, what’s bold, what’s a link) carries through.

Does this handle nested lists correctly?

Yes, properly nested ul/ol elements convert to correctly indented nested Markdown lists, preserving the original nesting depth.

What Markdown style does the output use — ATX or Setext headings?

ATX-style (# Heading) by default, which is the more common convention on GitHub, GitLab, and most modern static site generators, rather than the older Setext underline style.

Will code blocks keep their language for syntax highlighting?

If the source HTML’s code element has a language class (like class="language-js"), that language identifier carries through to the fenced code block’s opening backticks.

Can this convert a full webpage, or just a snippet?

It works on any HTML you provide, from a single paragraph to a full page's body content — very large or deeply structured pages may produce correspondingly long Markdown output.

What happens to images?

img tags convert to Markdown image syntax (![alt](src)), carrying over the alt text and source URL.

Is my HTML uploaded anywhere during conversion?

No. Turndown runs entirely in your browser via JavaScript — nothing is sent to a server at any point.

Will this preserve HTML elements Markdown has no equivalent for, like or ?

Structural wrapper elements with no Markdown equivalent are generally unwrapped, keeping their text content while dropping the tag itself, since Markdown has no concept of a generic container element.

Can I edit the Markdown output afterward?

Yes, the output appears in an editable text area, so you can adjust the generated Markdown before copying or downloading it.

HTML to Markdown Converter — Free Online, No Upload

FREE

Loading…

Go Pro ↑

Related Tools

Markdown to HTML

Convert Markdown to clean, semantic HTML

Markdown to PDF

Convert Markdown to a real, selectable-text PDF

Merge PDF

Combine multiple PDF files into one. Drag to set the page order you want.

Split PDF

Separate one PDF into multiple files — by page range or every page.

Compress PDF

Reduce PDF file size while keeping the best possible quality.

Remove Pages

Select and delete specific pages from your PDF document.

Your files never leave your device. All processing happens locally in your browser — nothing is uploaded to our servers.Files are never stored on our servers · No tracking of your file contentsPrivacy Policy

What is HTML to Markdown?

Going from HTML back to Markdown comes up constantly when you're migrating content — pulling a page out of a CMS, archiving a web article, or converting old HTML documentation into something that belongs in a Git repository README. This tool runs your HTML through Turndown, a well-established JavaScript library purpose-built for exactly this direction of conversion, and produces clean, readable Markdown.

Turndown walks the HTML's DOM structure and maps each element to its Markdown equivalent: headings become #-prefixed lines, strong/em become bold/italic markers, links and images become their bracket-and-parenthesis Markdown syntax, and code blocks become fenced triple-backtick blocks. Unlike a naive regex-based converter, working from the actual parsed DOM means nested and oddly-formatted HTML still converts correctly, since the structure is understood rather than pattern-matched.

The output uses ATX-style headings (# Heading, the GitHub-familiar style) and fenced code blocks by default, matching the Markdown conventions most platforms and static site generators expect today, rather than the older Setext-style headings or indented code blocks some converters default to.

Need to go the other direction and turn Markdown into HTML? Use Markdown to HTML.

How It Works

Turndown parses your HTML into a DOM tree (using the browser's own HTML parser), then walks that tree node by node, applying a set of conversion rules that map each HTML element to its Markdown syntax equivalent — headings to #, strong/b to **, em/i to *, a to [text](url), and so on. Because it operates on the real parsed structure rather than string patterns, nested formatting and irregular markup convert reliably.

How to Use

Paste or upload your HTML

Type directly into the text area, paste existing HTML, or upload an .html file.

Click Convert to Markdown

Turndown parses the HTML’s DOM structure and maps it to Markdown syntax.

Review the output

The generated Markdown appears in an editable text area — adjust it if needed.

Copy or download

Copy the Markdown to your clipboard, or download it as a standalone .md file.

Who Uses This Tool

📦

CMS Content Migration

Pull HTML content out of a CMS export and convert it to Markdown for a new static-site-based workflow.

📚

Documentation Archival

Convert old HTML documentation into Markdown files suitable for a Git repository.

📰

Article Archiving

Save a web article’s content as clean, portable Markdown instead of raw HTML.

💻

README Generation

Turn HTML project notes or a webpage’s content into a Markdown README.

✍️

Content Repurposing

Convert HTML newsletter or blog content into Markdown for reuse in a different platform.

🔄

Platform Migration

Move content between platforms that store HTML and ones that expect Markdown source.

Why Choose This Tool

DOM-Based Conversion

Parses real HTML structure rather than regex pattern matching, handling irregular markup reliably.

Fully Local Processing

Turndown runs in your browser via JavaScript — nothing is uploaded.

Modern Markdown Conventions

ATX headings and fenced code blocks match what GitHub and static site generators expect.

Editable Output

Tweak the generated Markdown directly before copying or downloading.

No Size Limits

Convert documents of any length, limited only by your browser's memory.

Free, No Watermark

100% free with no account required and no watermark on the output.

Key Benefits

Parses real DOM structure, not regex pattern matching

ATX-style headings and fenced code blocks by default

Browser-based — your document is never uploaded to a server

Handles nested formatting and irregular HTML reliably

No size limit beyond your browser's available memory

Instant conversion — no waiting on a server round trip

No account needed for standard file sizes

100% free with no watermark

Frequently Asked Questions

Free Online Document Tools for Everyone

iLoveDocsTools is used by students, professionals, and businesses across the United States, Canada, United Kingdom, Australia, India, and more than 100 other countries. All tools are browser-based and process files privately — your files never leave your device. Free to use, with Pro plans for unlimited access.

HTML to Markdown