How do I convert HTML to Markdown?

Paste your HTML into the box at the top, or upload an .html file. The tool parses it in your browser and returns Markdown you can copy or download as a .md file. Adjust heading, bullet, emphasis, and code-block style with the option chips if you need a specific flavour.

Is there a free HTML to Markdown converter online?

Yes — this one is free, needs no sign-up, shows no ads, and runs entirely in your browser. Your HTML never leaves your device: there is no server upload, so it is safe for private or client content.

How do I convert a web page to Markdown for a README?

Open the page, select the part you want, copy it, and paste it here — the browser gives us the underlying HTML. The tool converts headings, links, lists, and code into GitHub-Flavored Markdown you can drop straight into a README.md. Turn on GFM extras for tables and task lists.

Does HTML to Markdown keep tables and code blocks?

Yes. With GFM extras on (the default), becomes a pipe table with a --- delimiter row, and becomes a fenced code block with its language when a language- class is present. Turn GFM off and tables are flattened to plain text instead, since standard CommonMark has no table syntax.

Can I convert copied rich text from a website or Google Doc?

Usually, yes. When you copy formatted text, the source HTML travels with it. Paste it here and the formatting — bold, italics, links, lists — maps to Markdown. Inline CSS, colours, and fonts are intentionally dropped because Markdown has no styling primitives.

Is it safe to paste HTML with scripts into this tool?

Yes. With the Sanitize option on, , , , and inline event handlers are removed before conversion, and javascript: URLs are stripped from links. The preview runs in a locked-down sandboxed iframe with scripts disabled, so pasted markup can never execute.

Which Markdown spec does the output follow?

Output follows the CommonMark 0.31.2 specification for core syntax — ATX/Setext headings, emphasis, links, lists, block quotes, and code — plus the GitHub-Flavored Markdown extensions (pipe tables, strikethrough, task lists) when GFM extras are enabled.

Why does the element count sometimes say the counts differ?

The tool counts headings, tables, code blocks, and other elements two independent ways: once while walking the parsed DOM, and once by scanning the raw HTML. When they agree it shows “cross-checked by 2 methods.” A difference usually means the source HTML was malformed enough that the browser repaired it during parsing.

Utility · Developer

HTML to Markdown Converter

Paste raw HTML or rich text and get clean, spec-compliant Markdown back instantly — headings, links, GFM tables, task lists, and code blocks preserved. Everything runs in your browser; the HTML never leaves your device. No signup, no ads.

By Induwara Ashinsana— Executive Director, Ryzera TechnologiesUpdated Jul 10, 2026

HTML to Markdown ConverterIn-browser · no upload

Stays on your device

Paste HTML

Everything happens in your browser. Nothing is uploaded.

Or upload an .html file

Markdown output

Read-only. Use Copy or Download .md to take it with you.

Headings

Bullet marker

Emphasis

Code blocks

Extras

Conversion runs in your browser; no DOM is available here.

Words · Characters

0 · 0

Headings · Code blocks

0 · 0

Cross-checked by 2 methods

Links · Images

0 · 0

Tables · List items

0 · 0

Rendered previewGitHub-Flavored

Paste HTML on the left, or press “Load sample,” to see the converted Markdown rendered here.

The preview renders the produced Markdown back to HTML — a round-trip check that nothing was lost. Built to CommonMark 0.31.2 + GFM. Sources verified 2026-07-10, listed in “Sources & references” below.

How it works

The converter is a pure, deterministic transform: the same HTML and the same options always produce the same Markdown. There is no AI, no server, and no network call. Conversion happens in four steps.

Parse.Your pasted string is parsed to a DOM tree with the browser's native DOMParser in text/html mode. This tolerates malformed or partial HTML the same way a browser tab would, so you can paste a fragment without a full document wrapper.
Sanitise. When the Sanitize option is on, <script>, <style>, <iframe> and inline event handlers are removed, and dangerous URL protocols like javascript: are stripped from links. Nothing executable can survive into the output.
Walk and map. The tool traverses the DOM depth-first and maps each node to CommonMark 0.31.2: <h1>–<h6> to ATX # headings (§4.2), <strong> to **bold** (§6.4), <a> to [text](url) (§6.6), <ul>/<ol> to lists (§5.2–5.3), <pre><code> to fenced code (§4.5), and <blockquote> to > quotes (§5.1). Text is escaped so stray Markdown delimiters render literally — with one nuance: an underscore inside a word (like snake_case) is left alone, because CommonMark §6.2 already treats intraword _ as literal.
GFM extensions. With GFM extras on, <table> becomes a pipe table with a | --- | delimiter row, <del> becomes ~~strikethrough~~, and a checkbox inside a list item becomes a - [x] task list item.

The element count under the output is verified two independent ways — once by walking the parsed DOM and once by scanning the raw HTML with regular expressions. When both agree, the summary shows “cross-checked by 2 methods,” the same reconciliation approach used across the site's converters. The rendered preview then re-renders the produced Markdown back to HTML as a round-trip sanity check.

Worked examples

Inline formatting (defaults: ATX, _ emphasis)

HTML in

<h1>Hello</h1>
<p>This is <strong>bold</strong> and <a href="https://induwara.lk">a link</a>.</p>

Markdown out

# Hello

This is **bold** and [a link](https://induwara.lk).

Each <h1> maps to a single # (CommonMark §4.2), <strong> to **…** (§6.4), and the <a href> to inline [text](url) link syntax (§6.6).

GFM table, list, and code block (GFM on)

HTML in

<h2>Tasks</h2>
<ul><li>Ship v1</li><li>Write docs</li></ul>
<table><thead><tr><th>Tool</th><th>Free</th></tr></thead>
<tbody><tr><td>html2md</td><td>Yes</td></tr></tbody></table>
<pre><code>npm i turndown</code></pre>

Markdown out

## Tasks

- Ship v1
- Write docs

| Tool | Free |
| --- | --- |
| html2md | Yes |

```
npm i turndown
```

The <table> gains a | --- | delimiter row (GFM §4.10), each <li> becomes a hyphen bullet (§5.2), and <pre><code> becomes a fenced ``` block (CommonMark §4.5).

Blockquote with nested emphasis (edge: a block inside a block)

HTML in

<blockquote><p>Quote with <em>emphasis</em></p></blockquote>

Markdown out

> Quote with _emphasis_

The <blockquote> prefixes each produced line with '> ' (§5.1); the inner <em> uses the chosen emphasis delimiter, _ by default (§6.4).

Frequently asked questions

Sources & references

The mapping rules and spec citations were last cross-checked against the CommonMark and GFM specifications on 2026-07-10. The page is reviewed whenever either specification is amended.

Related tools

LiveUtility

Binary Translator

Convert text to binary (8-bit per byte) and decode binary back to readable text in your browser. Supports UTF-8 and 8-bit ASCII, an adjustable byte separator, and live character, byte and bit counters. Free, no signup, sources cited.

Open tool

LiveUtility

CSV to JSON Converter

Paste or upload CSV/TSV and get clean JSON instantly — quoted fields, custom delimiters, automatic type inference, and dot-notation nesting. Array of objects, array of arrays, or column-keyed output. Runs entirely in your browser, nothing uploaded.

Open tool

LiveUtility

ASCII Table & Converter

A complete, searchable ASCII chart (0–127) with decimal, hex, octal, binary, glyph, HTML entity and RFC 20 control names — plus a two-way converter between text and ASCII codes. Runs entirely in your browser, no signup.

Open tool

Rate this tool

Be the first to rate

Comments & feedback

Spotted a bug or want an improvement? Tell us — our team reviews every comment, and good ideas get built. Comments are public and anonymous.

Found a bug, edge case, or want to suggest an improvement?

Email me at [email protected] — most fixes ship within 24 hours.