WaywardTools

Document conversion that stays on your machine

Markdown HTML Swap

Markdown to HTML

Your file never leaves this device. Conversion runs in your browser. The document itself is not uploaded.

1 · Choose a Markdown file

…or drop a Markdown file here

.md, .markdown, .mdown, .mkd · stays in this tab

2 · Convert

3 · Download

Choose a file to convert. It is not uploaded.

FAQ and format details
Why convert Markdown to HTML?

README files, Obsidian notes, and documentation sites are authored in Markdown but published as HTML. Converting here is useful when you want a self-contained .html without running a static-site generator, or when you need to inspect how tables and code fences will look before you commit.

How this conversion runs

YAML front matter between --- lines is ignored (you will see a warning). The remaining text is parsed as GitHub-Flavored Markdown: tables, strikethrough, task lists, and fenced code. Raw HTML inside the Markdown is sanitized — scripts and event handlers will not survive into the hub.

Keep in mind for Markdown → HTML

Obsidian wikilinks, footnotes, and callout blocks are not GFM. They will show up as odd punctuation or ordinary links. Diagram source (Mermaid) stays as a code block; it is not rendered to SVG here. If you relied on a particular Markdown flavor (CommonMark vs MDX vs GitHub), expect small list and HTML-passthrough differences.

After you have a HTML file

Open the .html locally to proof. For a CMS, copy the body. If the next reader is Word, continue to DOCX from this HTML (or use Markdown→DOCX on this site, which is the same hub). Keep the .md as the source of truth; the HTML is a projection.

Which Markdown dialect is this?

GitHub-Flavored Markdown (GFM) via marked: ATX headings, pipe tables, fenced code, strikethrough, and task-list checkboxes. It is not MDX and not CommonMark-strict in every edge case.

Why did my front matter disappear?

The block between leading --- lines is YAML metadata, not prose. It is stripped so it does not become a heading soup. Put that metadata back in your site generator; this tool converts the document body.

This pair at a glance
Accepts
.md, .markdown, .mdown, .mkd
Writes
.html · text/html
Read fidelity
high (Markdown → HTML)
Write fidelity
exact (HTML → HTML)
Source size
Plan for files under 3.8 MB

The file is read in this tab. It is not uploaded.

Something off with this pair? Send feedback.

About Markdown and HTML

Source file

Markdown

A lightweight plain-text syntax for structured writing that compiles to HTML. The lingua franca of README files, wikis, and note apps.

Markdown stores documents as readable plain text with a small set of punctuation conventions for headings, emphasis, lists, links, and code. GitHub-Flavored Markdown (GFM) adds tables, strikethrough, task lists, and fenced code blocks. Conversion through HTML is a natural fit because Markdown was designed as an HTML shorthand.

Extensions
.md, .markdown, .mdown, .mkd
MIME types
text/markdown, text/x-markdown
Kind
text · utf-8
Category
markup
Standard
Open format · since 2004
Comfortable size
Up to about 3.8 MB in this browser converter
Read into HTML
high fidelity · implemented — Parsed as GitHub-Flavored Markdown.

What this format can hold

  • headings
  • paragraphs
  • lists
  • tables
  • links
  • images
  • inline formatting
  • code blocks
  • blockquotes

Usually dropped on the way in

  • raw html passthrough is sanitized

Apps that consume Markdown

  • GitHub (GitHub) — creates and opens on Web
  • Obsidian (Dynalist) — creates and opens on Windows, macOS, Linux, iOS, Android
  • VS Code (Microsoft) — creates on Windows, macOS, Linux
  • Typora — creates and opens on Windows, macOS, Linux
  • Notion — creates and opens on Web, Windows, macOS
  • Jupyter — creates and opens on Web
  • Discord — opens on Web, Windows, macOS, iOS, Android

Catalog notes

  • Front matter (YAML between --- lines) is preserved as a prefix when converting from Markdown, and ignored when converting to Markdown.
  • Obsidian wikilinks and footnotes have no lossless HTML equivalent yet.

Destination file

HTML

The web’s native document format: structured markup for headings, paragraphs, lists, tables, links, and media.

HTML is the pivot format for this converter. Incoming files are turned into a sanitized HTML document, and outgoing files are generated from that document. Browsers, email clients, and most rich-text editors already speak it, which is why it is the most flexible interchange point.

Extensions
.html, .htm, .xhtml
MIME types
text/html, application/xhtml+xml
Kind
text · utf-8
Category
markup
Standard
Open format · since 1993
Comfortable size
Up to about 7.6 MB in this browser converter
Written from HTML
exact fidelity · implemented — Pretty-printed full HTML document with a generated title.

What this format can hold

  • headings
  • paragraphs
  • lists
  • tables
  • links
  • images
  • inline formatting
  • semantic structure

Apps that consume HTML

  • Chrome (Google) — opens on Windows, macOS, Linux, Android
  • Firefox (Mozilla) — opens on Windows, macOS, Linux, Android
  • Safari (Apple) — opens on macOS, iOS
  • Edge (Microsoft) — opens on Windows, macOS
  • VS Code (Microsoft) — creates on Windows, macOS, Linux
  • WordPress — creates and opens on Web

Catalog notes

  • Scripts, event handlers, and external stylesheets are stripped during conversion so the hub stays a document, not an app.
  • XHTML is accepted as input and emitted as HTML5.
Other conversions

Other conversions from Markdown: WordRTFOpenDocumentPDFEPUB

Other ways to get HTML: WordRTFOpenDocumentPDFEPUB