Document format

MD converter

A .md file is a Markdown document: plain text with lightweight conventions — # for headings, ** for bold, - for lists — that convert cleanly to HTML. It stays readable as raw text, which was the entire point of the design.

Private for supported formats — processed in your browser

Convert supported files

Runs on your device

Drop MD files here

Batch files can each use a different output. Nothing uploads for local conversions.

Working inputs include camera RAW, browser-local audio/video, PDF, CBZ/CBR comics, office documents, ebooks, markup, 3D models, structured text, images, and archives.

Where MD comes from

John Gruber released Markdown in 2004 as a Perl script and a philosophy — write for humans first — with Aaron Swartz contributing to the syntax. Ambiguities in the original description led to CommonMark's rigorous specification in 2014, and GitHub Flavored Markdown layered tables, task lists, and fenced code blocks on top.

How MD works

  • Inline HTML is legal Markdown, providing an escape hatch for anything the lightweight syntax lacks.
  • CommonMark pins down parsing with hundreds of normative examples; dialects like GFM extend it.
  • Fenced code blocks carry a language tag that renderers use for syntax highlighting.
  • There is no binary structure whatsoever — any text editor is a Markdown editor.

When to use MD

  • README files and documentation in code repositories.
  • Note-taking apps such as Obsidian and Bear.
  • Source content for static site generators.
  • Comments and posts on GitHub, Reddit, and countless forums.

Strengths and limitations

Strengths

  • Legible both raw and rendered.
  • Ideal for version control — diffs read like prose edits.
  • Converts to HTML, PDF, and DOCX through tools like Pandoc.
  • The core syntax takes minutes to learn.

Limitations

  • Dialect fragmentation: tables, footnotes, and highlights differ per flavor.
  • No native control over page layout or typography.
  • Complex tables become painful to author and maintain.

Compatibility

GitHub, GitLab, and most developer platforms render .md automatically, editors like VS Code preview it live, and every plain-text editor can modify it. Dedicated Markdown apps exist on all desktop and mobile platforms.