What This Tool Does
Markdown is the lightweight markup language used by GitHub READMEs, blog posts, technical docs, and most text-first writing tools. HTML is the markup of every web page. The Microapp HTML to Markdown converter takes any HTML — pasted snippet, full page export, copied content from a CMS — and converts it to clean Markdown instantly. Runs in your browser, your content never leaves your device.
The most common reason to convert: you're moving content from one system to another (CMS to static site generator, web page to documentation, email to blog post) and need it in a format that's editable as plain text.
How to Use It
- Paste your HTML into the input box.
- The Markdown output appears instantly in the output box.
- Click "Copy" to put the Markdown on your clipboard.
<h2>Hello</h2><p>This is <strong>bold</strong> and <em>italic</em>. <a href="/about">About</a>.</p>Output Markdown:
## Hello
This is **bold** and *italic*. [About](/about).
What Gets Converted Cleanly
| HTML element | Markdown equivalent |
|---|---|
<h1> through <h6> | # through ###### |
<strong> or <b> | **bold** |
<em> or <i> | *italic* |
<a href="..."> | [text](url) |
<img src="..." alt="..."> |  |
<ul> + <li> | - item |
<ol> + <li> | 1. item |
<blockquote> | > quote |
<code> | `inline code` |
<pre><code> | Triple-backtick code block |
<hr> | --- |
What Doesn't Convert (And What to Do)
Tables. Markdown supports basic tables (with pipes), and most converters handle simple <table> elements. Complex tables with merged cells (colspan, rowspan) don't have a Markdown equivalent — you may need to keep them as HTML in the output, or simplify the structure.
CSS classes and inline styles. Markdown has no styling primitives — they're stripped during conversion. If your HTML had a custom callout box styled via CSS, the converted Markdown loses the styling (just the text content remains).
JavaScript and dynamic content. Anything dynamic (interactive elements, embedded apps, scripts) gets dropped. Markdown is static.
Embedded media beyond images. <video>, <audio>, <iframe> aren't standard Markdown. Most static site generators allow inline HTML in Markdown for these — you can paste the HTML tag verbatim.
Comments and metadata. HTML comments (<!-- ... -->) typically aren't preserved. Document metadata (<meta> tags from a full page) is dropped — copy frontmatter manually.
Common Use Cases
Migrating from a CMS to a static site generator. Export your WordPress / Ghost / Webflow posts as HTML, convert to Markdown, drop the .md files into your Hugo / Astro / Jekyll site. The Microapp converter handles the per-post conversion; you'll still need scripting for bulk migration.
Pasting web content into Notion, Obsidian, or other Markdown-native apps. Notion's web clipper produces variable-quality Markdown; the Microapp converter is more predictable.
Cleaning up emails for blog republishing. Email HTML is famously messy (table-based layouts, inline styles everywhere). Converting to Markdown strips the noise and gives you a clean draft to edit.
Documentation imports. Pulling docs from an internal wiki to put in a public docs site. The conversion handles the structure; you adjust prose by hand.
Common Quirks to Watch For
Whitespace handling. HTML collapses whitespace; Markdown sometimes preserves it. The converter normalizes excessive whitespace but may not match the original exactly. Eyeball the output, especially around code blocks.
Nested lists. Multi-level lists generally convert correctly, but the indentation can be inconsistent depending on the source. Verify nested levels in the output.
Special characters in text. Markdown uses *, _, #, [, ], (, ) as syntax. If your text contains literal versions of these, they need escaping (\*) — the converter handles this for common cases, but unusual content might need manual fixes.
Related Tools
For the inverse conversion (Markdown to HTML), use the Markdown to HTML converter. To work with HTML special characters specifically (encode/decode entities), the HTML Encoder/Decoder is the right tool. For URL-encoding strings inside Markdown links, see the URL Encoder/Decoder.