Skip to main content

Markdown ↔ HTML Converter

Convert Markdown to HTML and back. Live preview included.

100% Private — Your files never leave your device.

All processing happens in your browser. Nothing is uploaded to any server.

Drop a file here or click to browse

Drop a .md or .html file

Max 50MB per file

Paste content or upload a file to get started

Powered by CalcRun

How it works

What Is Markdown?

Markdown lets you write formatted content using plain text. Instead of clicking buttons in a word processor, you use simple symbols:

# Heading 1
## Heading 2

**Bold text** and *italic text*

- Bullet point
- Another point

[Link text](https://example.com)

> Blockquote

It’s the standard for technical documentation, GitHub READMEs, blog platforms like Ghost and Hugo, and note-taking apps like Obsidian and Bear.

How This Tool Works

Markdown → HTML uses the marked library (loaded on demand) to parse Markdown syntax and generate standards-compliant HTML. The library handles all CommonMark syntax plus common extensions like tables and task lists.

HTML → Markdown uses a rule-based converter that recognizes common HTML patterns and translates them back to Markdown syntax. It handles headings, paragraphs, emphasis, links, images, lists, blockquotes, code blocks, and horizontal rules.

All conversion happens in your browser — no data is sent to any server.

Common Use Cases

ScenarioDirection
Writing a blog post in Markdown, need HTML for CMSMarkdown → HTML
Migrating website content to a static site generatorHTML → Markdown
Previewing Markdown before committing to GitHubMarkdown → HTML (Preview)
Cleaning up messy HTML from a WYSIWYG editorHTML → Markdown → HTML
Creating an email newsletter from Markdown notesMarkdown → HTML

Real-World Examples

1

Blog post for WordPress

Mode: Markdown to HTML Input File: blog-post.md

A blogger writes a 2,000-word article in Markdown with headings, bold text, links, and an image. Converting to HTML produces clean, semantic markup ready to paste into WordPress's HTML editor. No manual formatting needed — the HTML preserves all structure.

2

Website migration to Hugo

Mode: HTML to Markdown Input File: about-page.html

A developer migrates 50 pages from a legacy PHP site to Hugo (a Markdown-based static site generator). Converting each HTML page to Markdown strips the complex HTML and produces clean, editable content files. Headings, links, and formatting are preserved.

3

Email newsletter from notes

Mode: Markdown to HTML Input File: newsletter.md

A marketer drafts a weekly newsletter in Markdown for readability, then converts to HTML for their email platform. The Preview mode lets them check formatting before copying the HTML into Mailchimp or ConvertKit.

Frequently Asked Questions

What is Markdown?
Markdown is a lightweight markup language created by John Gruber in 2004. It uses simple text symbols to format content — # for headings, ** for bold, * for italic, - for lists. It's widely used for README files, documentation, blog posts, and note-taking because it's human-readable even without rendering.
Why convert Markdown to HTML?
Markdown needs to be converted to HTML for web browsers to display formatted content. If you're writing content for a website, blog, or email newsletter, you'll need the HTML output. Content management systems like WordPress, Ghost, and many static site generators handle this conversion automatically, but sometimes you need the raw HTML.
Why convert HTML to Markdown?
Converting HTML to Markdown is useful when you want to edit web content in a plain text editor, migrate content from a website to a Markdown-based system (like a static site generator), or simplify complex HTML into clean, readable text. The conversion strips out HTML complexity and gives you clean, editable markup.
Does the HTML to Markdown conversion handle all HTML tags?
The converter handles common HTML elements: headings (h1-h6), paragraphs, bold, italic, code, links, images, lists, blockquotes, and horizontal rules. Complex HTML features like tables, forms, iframes, and custom CSS won't convert to Markdown equivalents because Markdown doesn't support them. Any unrecognized tags are stripped.
Can I use this as a Markdown preview tool?
Yes — click the 'Preview' button to see a rendered preview of your Markdown alongside the source code. This makes it a quick way to check how your Markdown will look when rendered, without needing a full editor like VS Code or Typora.