1. Home
  2. Documents
  3. HTML to Markdown

HTML to Markdown

Convert HTML code or copied web content into Markdown.

Runs in your browser · No upload

Loading the converter…

Pasted HTML is parsed for conversion only | never displayed or executed | and never uploaded.

How to use

  1. Paste HTML code | or paste content copied straight from a web page, Word or Google Docs. With “Paste content copied from web pages as HTML” on, the HTML that travels with your clipboard is used, so headings, bold text, links and tables carry over.
  2. Pick heading style (# or underlined), bullet marker (- * +), code block style, link style and italic marker.
  3. Copy the result or download it as an .md file | ready for Notion, a GitHub README, static site generators (Jekyll, Hugo, Astro) or Obsidian.

What becomes what

HTML Markdown
<h2>Intro</h2> ## Intro
<strong>bold</strong>, <em>italic</em> **bold**, _italic_
<a href="https://a.com">text</a> [text](https://a.com)
<img src="a.png" alt="alt text"> ![alt text](a.png)
<ul><li>item</li></ul> - item
<pre><code class="language-js"> a ```js fenced block (language kept)
<del>, <s> ~~strikethrough~~ (GFM)
<input type="checkbox" checked> [x] (GFM)
<table> a | cell | cell | table; align becomes :---: or ---: (GFM)

Tags such as <script>, <style>, <head> and <iframe> are dropped along with their contents. Characters in your text like *, _ or 1. are escaped (\*) so they aren’t mistaken for Markdown syntax.

Things to watch out for

  • Anything Markdown can’t express | text color, fonts, merged cells (colspan), multi-paragraph table cells | is lost or flattened onto one line.
  • GFM tables need a header row, so a table without <thead> uses its first row as the header.
  • The three spaces after a bullet (- item) are turndown’s default, keeping nested paragraphs and code aligned inside list items. It renders exactly like a single space.

FAQ

Could pasted HTML run scripts?

No. The HTML is never inserted into the page; it’s parsed into a separate inert document for conversion, so scripts don’t run and images aren’t fetched. Nothing is uploaded.

How do I check what the Markdown looks like?

Paste it into Markdown Preview. To tidy the HTML itself, use the HTML Beautifier & Minifier.

Can't find the tool you need?

Tell us what you want to do. We build the most requested tools first.