Skip to content
Morphr

Document format · .md

What is a Markdown file?

Markdown is a lightweight plain-text markup language created by John Gruber with Aaron Swartz in 2004, designed so that the source stays readable even before it is rendered. A handful of punctuation conventions — hashes for headings, asterisks for emphasis, hyphens for lists — turn ordinary text into structured documents.

Full name
Markdown
Category
Document
File extension
.md, .markdown
MIME type
text/markdown
Developer
John Gruber & Aaron Swartz
First released
2004
Compression
None (plain text)
Standard
Open (CommonMark)

Convert a Markdown file

Locally in your browser — nothing is uploaded. Pick a target format:

Readable as source, structured when rendered

Markdown’s founding idea was that a marked-up document should still read cleanly as plain text. A heading is just a line beginning with a hash, a list is a series of dashes, and emphasis is a word wrapped in asterisks — conventions borrowed from how people already formatted plain-text email. Because the syntax never gets in the way, you can read and edit a Markdown file in any text editor and understand it instantly. When you do want polish, a converter renders it to HTML, PDF or a Word document with proper headings and styling applied.

Flavours and standardisation

Gruber’s original description left several edge cases undefined, and over the years implementations diverged into competing flavours. CommonMark emerged to pin down a precise, unambiguous specification, and GitHub Flavored Markdown extended it with tables, task lists, strikethrough and fenced code blocks that developers now treat as standard. Most tools you meet today speak some blend of these. The practical upshot is that core Markdown is universally portable, while the fancier extensions are worth checking against whatever tool will ultimately read your file.

Strengths

  • Stays perfectly legible as raw text, with or without a renderer.
  • Trivial to learn — a few symbols cover the bulk of everyday formatting.
  • Plays beautifully with version control, since changes show up as clean line diffs.
  • Converts cleanly into HTML, PDF, DOCX and many other targets.

Limitations

  • Competing flavours mean a document can render differently from one tool to the next.
  • Complex layout, precise spacing and multi-column design are simply out of scope.
  • Tables and footnotes rely on extensions that base Markdown never defined.
  • Anything beyond light formatting usually means dropping into raw HTML.

When to use Markdown

Use Markdown for READMEs, notes, documentation and any writing where you want a clean, durable source that converts easily and reads well untouched.

Markdown FAQ

What opens a Markdown file?
Any text editor opens a .md file, since it is just plain text. Editors like VS Code, Obsidian and Typora additionally show a live formatted preview alongside the source.
What is the difference between CommonMark and GitHub Flavored Markdown?
CommonMark is a strict specification that resolves the ambiguities in the original Markdown, and GitHub Flavored Markdown builds on it by adding tables, task lists and fenced code blocks. GFM is effectively CommonMark plus those developer-friendly extras.
Can I turn Markdown into a Word document?
Yes. Morphr converts Markdown to and from HTML, PDF, DOCX, EPUB, RTF and ODT in the browser, preserving your headings, emphasis, lists and links along the way.