Markdown ↔ HTML

Bidirectional converter: turn Markdown into clean HTML with live preview, or convert HTML back to Markdown with configurable output options (heading style, code blocks, bullets). 100% client-side.

Free Runs in your browser
Direction:

How to use

  1. 1 Select the conversion direction at the top: Markdown → HTML or HTML → Markdown.
  2. 2 In Markdown → HTML mode: type or paste Markdown — the HTML output and live preview update side by side as you type. Click Copy to grab the HTML.
  3. 3 In HTML → Markdown mode: paste HTML markup into the left panel, customize the output options (heading style, code block format, bullet marker, horizontal rule style), and the clean Markdown appears on the right automatically.
  4. 4 Use it to convert README files to HTML for your CMS, or to migrate content from a WYSIWYG editor to Markdown.
  5. 5 All processing runs in your browser — no data is sent to any server.

Key features

  • Bidirectional: convert Markdown → HTML with live preview, or HTML → Markdown with configurable output options
  • Markdown → HTML mode: side-by-side preview and raw HTML output — ideal for blog posts, READMEs, and docs
  • HTML → Markdown mode: customizable heading style (ATX/Setext), code block format, bullet markers, and HR style
  • Live preview updates as you type in both directions — no button to press
  • Uses Turndown library for spec-compliant HTML-to-Markdown conversion
  • 100% client-side — your content never leaves your browser

What is Markdown?

Markdown is a lightweight markup language created by John Gruber in 2004. The core idea: write plain text with minimal formatting characters, and convert it to clean HTML whenever needed. A line starting with # becomes an <h1>; **bold** becomes <strong>.

The original spec had ambiguities, so multiple competing flavors emerged. Today, CommonMark is the widely adopted standard, and GitHub Flavored Markdown (GFM) extends it with tables, task lists, and syntax-highlighted code fences — most documentation tools support GFM.

Common Use Cases

Static site generation

Convert Markdown content files to HTML for rendering in static site generators like Astro, Hugo, or Jekyll.

Email and newsletter content

Write email copy in Markdown and convert it to inline-friendly HTML for sending through campaign tools.

Documentation migration

Convert existing Markdown README files or docs to HTML for rendering in a custom documentation portal.

CMS content import

Convert Markdown articles to HTML before importing them into a CMS that stores HTML (like WordPress).

Previewing Markdown output

Check exactly what HTML your Markdown will produce before committing to a repo or publishing.

Testing Markdown renderers

Compare the HTML output of different Markdown libraries to check for differences in parsing edge cases.

Markdown → HTML Output

The most used Markdown syntax and its HTML equivalent.

MarkdownHTML output
# Heading<h1>Heading</h1>
**bold**<strong>bold</strong>
*italic*<em>italic</em>
[text](url)<a href="url">text</a>
```lang↵code↵```<pre><code class="lang">code</code></pre>
> blockquote<blockquote>blockquote</blockquote>