🔃 HTML to Markdown / Markdown to HTML Converter
Convert between HTML and Markdown formats bidirectionally. Supports headers, lists, tables, code blocks, links, images, and more.
Last updated: November 8, 2026 · By the BoltQuickTools team
Move simple content between HTML and Markdown
Moving a blog post to a static site, or dropping generated docs into a README, usually means rewriting the markup one way or the other. This page handles the common elements in both directions. Conversion runs in the page, but the preview can fetch files: images referenced in your content load from whichever server hosts them.
Converting a document
- Choose HTML to Markdown or Markdown to HTML. Switching clears both boxes.
- Paste into the input box and the conversion runs. If you type or edit instead, press Convert; there is no conversion while typing.
- Check Live Preview, then press Copy Output.
- The Basic Sample, Table Sample, Code Sample and Full Sample buttons fill the input for the current direction. Press Convert afterwards.
HTML in, Markdown out
<h2 class="t">Release notes</h2><p>Fixed the <code>retry</code> bug in <a href="/api">the API</a>.</p>
<ul><li>One<ul><li>Nested</li></ul></li><li><strong>Two</strong></li></ul>
<table><tr><th>A</th><th>B</th></tr><tr><td>1</td><td>2</td></tr></table>
Produces this (the page leaves several blank lines between blocks, which Markdown treats the same as one):
## Release notes
Fixed the `retry` bug in [the API](/api).
- One
- Nested
- **Two**
| A | B |
| --- | --- |
| 1 | 2 |
HTML to Markdown limits
- The contents of
scriptandstyletags come through as text. Remove them from the HTML first. - Unknown tags keep their text and lose the markup, so
delloses its strikethrough. - Literal
*and|are not escaped, so a pipe in a table cell adds a column. - Classes and inline styles are dropped.
<ol start="5">still starts at 1. - A table's first row is always treated as the header.
Markdown to HTML limits
- This is a small line-by-line converter rather than a CommonMark parser. Strikethrough, task lists, automatic links, reference links,
===headings and indented code are not recognised. - Nested list items are flattened into one list.
- Formatting is applied inside inline code and words:
snake_case_namebecomessnake<em>case</em>name. - Link titles break the output:
[a](/b "title")produces a malformedhref. - Tables need a leading pipe on each row.
- Raw HTML passes straight through and is rendered by the preview. Event attributes in it can run, so do not paste Markdown from a source you do not trust.
Questions readers ask
Why is the output full of blank lines?
Each block adds its own spacing, and the page does not collapse the runs. It renders the same in Markdown. Your editor's formatter, or find and replace, will tidy it.
Is this the right page for writing Markdown?
For writing and previewing as you go, the Markdown editor suits better, and the Markdown table generator builds tables for you. Use this page when you already have a document to convert.
Can I clean up the HTML first?
Yes, and it helps. The HTML tag stripper can drop script and style content while keeping the tags you list.