---
title: "How to convert HTML to Markdown | ToolSugar"
description: "Convert HTML to readable Markdown for notes, docs and static sites, and see which tags map cleanly and which are dropped."
canonical: https://toolsugar.com/blog/how-to-convert-html-to-markdown
image: https://toolsugar.com/og.png
---

# How to convert HTML to Markdown for notes and docs

Updated 2026-11-09

To convert HTML to Markdown, replace each tag with its plain text pattern, such as # for a heading and a dash for a list item. HTML to Markdown on ToolSugar does this in your browser with the Turndown library. Scripts in the pasted HTML never run.

[Open HTML to Markdown](https://toolsugar.com/tools/html-to-markdown)

## Convert HTML to Markdown in four steps

Paste the HTML or open an .html file. The Markdown updates as you edit.

1. Paste HTML into the HTML box, or open an .html file.
2. Read the Markdown in the result box on the right.
3. Edit your HTML if something converted differently than you expected.
4. Copy the Markdown, or press Download to save document.md.

## How tags become Markdown

Headings use # lines, bullets use a dash, and links and emphasis keep their Markdown syntax. Code blocks are wrapped in triple backtick fences.

These choices give a file that most Markdown tools read without changes.

## What does not convert

Tables are not turned into Markdown tables. Layout styling, such as colors, fonts and column widths, is dropped because Markdown has no way to say it.

If a table matters, copy it by hand after converting, or keep it as HTML, which most Markdown files allow.

## Paste a whole page or just the article

You can paste a full web page, and the body is converted. Menus, footers and navigation links come along as text or links, so the result can be noisy.

Copy only the part you need, such as the article body, and the Markdown will need much less cleanup.

## Questions

### Will scripts in my HTML run?

No. The HTML is parsed with DOMParser into a separate document that is never shown, so scripts and handlers stay inactive.

### Can I convert an HTML email?

Yes. Paste its source and you get readable text with the links intact. Images stay as image links, and layout tables lose their structure.

### Which file extension does the download use?

It saves as document.md, which any Markdown editor opens.

[Open HTML to Markdown](https://toolsugar.com/tools/html-to-markdown)

## Related guides

- [How to convert Markdown to HTML](https://toolsugar.com/blog/how-to-convert-markdown-to-html)
- [How to convert XML to JSON](https://toolsugar.com/blog/how-to-convert-xml-to-json)
- [How to format JSON online](https://toolsugar.com/blog/how-to-format-json)
- [How to format SQL queries](https://toolsugar.com/blog/how-to-format-sql)