Skip to content
ToolMug

HTML to Markdown Converter

Paste HTML source, or copy a section of any web page or document and paste it here, formatting and all. You get clean Markdown with headings, lists, links, tables and code blocks, ready for a README, a wiki or your notes.

Runs in your browser — nothing you enter is uploaded

How to use

  1. Copy part of a web page and paste it into the HTML box, or paste HTML source, or open an .html file.
  2. Pick the Markdown style you prefer for headings, lists, code blocks and links.
  3. Copy the Markdown or download it as a .md file.

Options explained

Paste from a web page
When you copy from a browser, Word or Google Docs, the clipboard also carries the HTML. With this option on, that HTML is converted, so headings and links survive. Turn it off to paste the plain text instead.
Headings
"# Heading" (ATX) works for all six levels. The underlined style (Setext) only exists for levels 1 and 2; deeper headings still use #.
Code blocks
Fenced blocks keep the language from class="language-js" so syntax highlighting still works on GitHub. Indented blocks use four spaces.
Links
Inline links keep the URL next to the text. Reference links move URLs to a numbered list at the end, which reads better when there are many.
GitHub Flavored Markdown
Converts tables, strikethrough and checkboxes. Without it, tables become plain text rows.

Example

HTML Markdown
<h2>Setup</h2> ## Setup
<p>Run <code>npm i</code> first.</p> Run `npm i` first.
<a href="https://x.dev">docs</a> [docs](https://x.dev)
<ul><li>One</li></ul> - One

Frequently asked questions

What happens to scripts, styles and iframes?

They are removed. Only content that Markdown can express is kept.

Why are some tables left as HTML?

Markdown tables cannot express merged cells, so tables that use them are kept as HTML, which GitHub and most Markdown renderers still display. Several paragraphs inside one cell are joined with <br>.

Are images converted?

Yes, as ![alt text](url). The image itself is not downloaded, so relative URLs may need to be made absolute.

Privacy

This tool runs entirely in your browser. Your files and text are processed on your device and are never uploaded to our servers.

Related tools