HTML to Markdown Converter

Headings
Bullet marker
Code blocks
Links

About the HTML to Markdown Converter

Markdown is a plain text format that README files, wikis, note apps and static site generators accept. When your content is in HTML, such as an article on a web page, an email or a CMS export, this tool turns it back into Markdown.

Paste HTML source, or copy something on a web page and paste it straight into the box, and the Markdown appears as you type. Headings, links, images, lists, quotes, code, tables, strikethrough and task lists are converted. Pick the heading style, bullet marker, code block style and link style you prefer, then copy the result or download it as a .md file. You can also upload an .html file. Scripts and other active content are removed, and everything happens in your browser.

How to convert HTML to Markdown

  1. Paste HTML, or copy from a web page and paste, or upload an .html file.
  2. Choose the heading, bullet, code block and link styles.
  3. Check the Markdown in the right box.
  4. Copy it or download it as a .md file.

Frequently asked questions

Can I paste text I copied from a web page?

Yes. Copy something on a web page, click the HTML box and paste. The page's formatting arrives as HTML and is converted straight away, so headings, links, lists and tables come out as Markdown. You can also paste HTML source code or upload an .html file.

Is it safe to paste HTML I did not write?

Yes. The HTML is read into an inert document that never runs scripts or loads images, and script, style, iframe, form and similar elements are removed before converting. Event handler attributes and javascript: links are dropped as well. Nothing in the pasted HTML can run on this page.

Which parts of HTML are converted?

Headings, paragraphs, bold, italic, links, images, ordered and unordered lists, blockquotes, code and pre blocks, horizontal rules, and the GitHub Flavored Markdown extras: tables, strikethrough and task lists. HTML with no Markdown equivalent, such as a table with merged cells, loses that layout.

Why does my table become plain HTML or lose its header?

Markdown tables need a header row. If the first row of your table uses td cells instead of th cells, the tool treats it as the header. Cells that span several columns or rows cannot be written in Markdown, so their content is placed in a single cell.

What do the style options change?

Heading style picks # headings (ATX) or underlined headings (Setext, which only exist for levels 1 and 2). Bullet marker sets the character used for lists. Code blocks can use backtick fences, tilde fences or four-space indentation. Links can be inline, or numbered references listed at the end.

Is my HTML uploaded anywhere?

No. The conversion runs in your browser and nothing leaves your device.