ZapKit

HTML to Markdown Converter

Turn HTML from a web page, CMS export or email into tidy Markdown for docs, notes apps, static sites and READMEs.

What is an HTML to Markdown converter?

An HTML to Markdown converter rewrites HTML markup as Markdown, the plain-text formatting syntax used by GitHub, documentation tools, static site generators like Hugo and Astro, and notes apps like Obsidian and Notion.

It's the quickest way to migrate blog posts out of WordPress, save a web article into your notes, turn a rich-text email into a README, or prepare content for a docs site. Instead of retyping headings, links and lists by hand, the structure is converted automatically while the text stays exactly as written.

How to use the HTML to Markdown Converter

  1. 1.Paste the HTML

    Page source, a CMS export or a snippet.

  2. 2.Choose the style

    # or underlined headings, the bullet character, and fenced or indented code.

  3. 3.Copy the Markdown

    Or download it as a .md file.

Example: a getting-started section

HTML with an h2, a paragraph with bold text and a link, a two-step ordered list, a code block and a blockquote:

<h2>Getting started</h2>
## Getting started
<strong>CLI</strong>
**CLI**
<a href="…/docs">docs</a>
[docs](https://example.com/docs)
<pre><code>
``` fenced block
<blockquote>
> Tip: use the latest version.

The converted section renders the same on GitHub and is easy to edit as plain text.

What converts and what doesn't

Headings, paragraphs, bold, italic, links, images, ordered and unordered lists, blockquotes, inline code and code blocks all have Markdown equivalents. Tables become pipe tables, with a header row when the HTML has one. Scripts and styles are dropped.

Things Markdown can't express, such as colours, fonts, layout divs and form fields, are reduced to their text. Superscripts and subscripts are kept as HTML tags, which most Markdown renderers accept.

Frequently asked questions

Can I convert a whole web page?

Yes, but menus and footers come along too. Copy just the article's HTML for a cleaner result.

Are tables supported?

Yes. Simple tables become Markdown pipe tables. Merged cells can't be represented and are flattened.

Which heading style should I use?

# hash headings work everywhere and support all six levels; underlined headings only cover levels 1 and 2.

Is it good for moving a blog to a static site?

Yes. Convert each post's HTML body and add your site generator's front matter at the top.

More Developer tools