Guide

How to convert Markdown to HTML

This walks through the whole workflow with real Markdown, from pasting text in to publishing the result. It takes a few minutes the first time and seconds after that.

1. Start with your Markdown

Paste Markdown directly into the editor, or upload a .md, .markdown, or .txt file (up to 750 KB). A heading and a short paragraph is enough to see the converter work:

Markdown input

# Getting Started

## Installation

Follow the steps below.

HTML output

<h1 id="getting-started">Getting Started</h1>

<h2 id="installation">Installation</h2>

<p>Follow the steps below.</p>

Headings automatically get unique id attributes, which is what makes the table of contents and in-page anchor links work.

2. Choose your settings

Above the editor you can set a document title, an output theme (light or dark), and whether to include a table of contents. These only affect the complete document output; an HTML fragment has no head, theme styles, or title.

3. Pick fragment or complete document

Switch Output type depending on where the HTML is going:

HTML fragment: just the converted content (headings, paragraphs, lists, and so on). Use this when pasting into a CMS editor, a static site generator, or an existing page.
Complete document: a full <!doctype html> page with embedded theme CSS, ready to open as a standalone file or host directly.

4. Check the preview and the source

The Preview tab renders your HTML inside a sandboxed iframe with scripting disabled, so you can see the visual result safely. The HTML source tab shows the exact markup that will be copied or downloaded; always worth a scan before you publish, especially for links and code blocks.

5. Copy or download

Copy HTML copies whichever output type is currently selected. Download complete HTML always saves a full standalone document, regardless of the output type toggle, so you get a working file even if you were viewing a fragment.

Common syntax you'll use most

Markdown input

This is **bold**, this is *italic*,
and this is ***both***.

HTML output

<p>This is <strong>bold</strong>, this is <em>italic</em>,
and this is <strong><em>both</em></strong>.</p>

See the examples page for links, images, lists, code blocks, blockquotes, and hard line breaks with their exact HTML output.

What isn't supported yet

The parser covers standard Markdown: headings, emphasis, links, images, ordered and unordered lists, blockquotes, horizontal rules, inline code, and fenced or indented code blocks. Extended syntax (tables, task lists, and strikethrough) is not currently interpreted, and any raw HTML you paste is escaped rather than rendered, by design (see Privacy for why).

Before you publish

Read the HTML source tab once, especially if the Markdown came from an AI tool or another converter.
Check that image and link URLs are the ones you intended; the converter only allows safe HTTP, HTTPS, mailto, relative, and fragment URLs.
If you're pasting into a CMS, use the HTML fragment output so you don't end up with a nested <html>/<body> inside your page.

Open the converter