Markdown to HTML Converter
Convert Markdown to clean HTML with a live preview: headings with anchor ids, nested and task lists, fenced code, tables with alignment, quotes, links and images. Raw HTML is escaped and unsafe links are removed.
How to Use
- Type or paste Markdown into the box, or press a preset to start from an example.
- The preview and the HTML update as you type.
- Choose HTML fragment to paste into an existing page, or Full page for a complete document with a doctype, head and title.
- Untick Heading ids if you do not want
idanchors on the headings. - Read Show Work to see how each block was recognised, then Copy the HTML or Download it as a file.
Worked Example
Convert these four lines (60 bytes):
# Release notes Fixed **two** bugs: - [x] Login - [ ] Export
Line 1 starts with one # and a space, so it is a level-1 heading: <h1 id="release-notes">Release notes</h1>. Line 2 is ordinary text, so it opens a paragraph, and **two** inside it becomes <strong>two</strong>. Line 3 starts with - , which ends the paragraph and starts a bullet list; [x] and [ ] make its two items a ticked and an unticked checkbox.
Result: three blocks — a heading, a paragraph and a list of two tasks — and 243 bytes of HTML.
The common mistake: expecting a single line break to show. “Roses are red” and “Violets are blue” typed on consecutive lines are one paragraph, rendered on one line as “Roses are red Violets are blue”. End the first line with two spaces (or a backslash) and it becomes Roses are red<br>; leave a blank line instead and you get two separate paragraphs.
Show Work
Syntax Reference
Where Markdown Came From
John Gruber released Markdown in 2004, with help from Aaron Swartz, as a Perl script and a description of a plain-text style that already looked like formatted text: asterisks for emphasis as people typed in email, hash marks for headings, hyphens for lists. The goal was text that reads well before it is converted.
The original description left many cases open, and dozens of converters disagreed on them. In 2014 a group including John MacFarlane, the author of Pandoc, published CommonMark, a precise specification with hundreds of examples. GitHub based its own GitHub Flavored Markdown on it and published that specification in 2017, adding the tables, task lists, strikethrough and autolinks most people now think of as part of Markdown.
About This Tool
This tool converts Markdown to HTML as you type: headings with unique anchor ids, paragraphs with hard line breaks, nested bullet, numbered and task lists, fenced and indented code with a language class, tables with column alignment, block quotes, rules, links, images and emphasis. It gives either a fragment to paste into a page or a complete HTML document, to copy or download.
Raw HTML in the input is escaped and link addresses are checked, so the preview is safe for Markdown pasted from anywhere, and the preview’s styles are confined to the preview box. Show Work lists every block the parser found, with its line number, and the counts of headings, lists, code and links. Everything runs in your browser.
Related tools: HTML Entity Encoder, Minifier / Beautifier, and Text Diff.
Frequently Asked Questions
Which Markdown does it understand?
The CommonMark basics — headings, paragraphs, emphasis, links, images, block quotes, bullet and numbered lists (nested by indenting two spaces), fenced and indented code, rules, hard line breaks and backslash escapes — plus the GitHub additions people expect: tables with column alignment, task lists (- [x]), strikethrough (~~text~~) and <https://…> autolinks. Reference-style links and footnotes are not supported.
What happens to HTML inside my Markdown?
It is shown as text, not run. <script> becomes <script>, so pasted Markdown from anywhere can never execute code or restyle this page. Links and images are checked too: only http, https, mailto, tel and relative addresses are kept (plus data: URLs for PNG, GIF, JPEG, WebP and AVIF images); a javascript: link becomes href="#", even in capitals or with spaces in front.
Why did my two lines become one?
In Markdown a single line break inside a paragraph is just a space: “Roses are red” and “Violets are blue” on consecutive lines render as one line. End the first line with two spaces or a backslash to get a , or leave a blank line between them to make two paragraphs.
What are the heading ids for?
They let you link straight to a section: ## Install becomes <h2 id="install">, so page.html#install jumps to it. The id is the heading text in lowercase with everything else turned into hyphens, and a repeated heading gets -1, -2 added so every id stays unique.
Is my text uploaded?
No. The converter is a small parser that runs in your browser; nothing you type is sent anywhere. Images in the preview are loaded from wherever their URLs point, just as they would be on a published page.
How do I use the Markdown to HTML Converter?
Just type or paste your value. The answer shows up right away — there is no button to press. Change anything and it updates by itself.
Do I need to install or sign up for anything?
Not at all — it runs in the browser with nothing to install and no account. After it loads once, it even works without an internet connection.
Is my information private?
Yes. Everything happens in your browser. Nothing you type is sent to a server or saved anywhere.
Common Use Cases
Blog posts and CMS fields
Write in Markdown, then paste the HTML fragment into a CMS that only accepts HTML.
README previews
Check how a README’s headings, tables and task lists will look before pushing it.
Email newsletters
Draft in Markdown and copy the generated HTML into an email builder’s code block.
Documentation pages
Turn notes into a standalone .html page with Full page and Download, with anchor ids ready for a table of contents.
Teaching Markdown
Show Work lists every block and how it was read, so a beginner can see why a list did or did not form.
Last updated: