AuraDoc
Sign inSign up

Markdown: plain text with light formatting

Markdown is a way of writing formatted documents as plain text. A hash sign starts a heading, a hyphen starts a list item, and a link is a word in square brackets followed by an address in round brackets. The file stays readable in any text editor, and programs turn it into formatted pages when they display it. John Gruber published the syntax in 2004; CommonMark later wrote a precise specification, and GitHub maintains a popular variant that adds tables.

Key facts

Extensions
.md, .markdown
Media type
text/markdown
Standard
RFC 7763 (text/markdown), CommonMark

Where it is used

Markdown is the usual format of README files in software projects, and it powers documentation sites, wikis and many note-taking apps. Developers write release notes and technical guides in it, students keep lecture notes, and writers draft articles before moving them to a layout program. Code hosts such as GitHub and GitLab show .md files as formatted pages automatically.

Strengths

Because it is plain text, Markdown opens anywhere, takes very little space and works well with version control, where every change shows up line by line. It is quick to type, needs no special editor and keeps the writer focused on content rather than layout. The same file can be turned into HTML, PDF or slides.

Limitations

Markdown has no fixed page layout. Fonts, margins and colours depend on the program that renders it, and dialects differ, so a table or footnote that works on one site may appear as raw symbols on another. Images are only links to separate files, which are easily lost when the .md file travels alone.

Converting it to PDF

Converting to PDF fixes the look: headings, lists, tables, quotes and code blocks become pages that print and read the same everywhere. Our Markdown to PDF tool accepts .md and .markdown files of up to 1 MB and applies a simple, readable style. Images that point to the internet are not loaded, so check the result when the document relies on pictures.

Getting it back from a PDF

There is no direct way back from PDF to Markdown in our tools. PDF to text recovers the words of a digital PDF, and you then add the Markdown marks for headings and lists again by hand.

Convert with these free tools

Side-by-side comparisons

PDF terms explained

Guides that put it into practice

Common questions

What is the difference between .md and .markdown?
None. Both extensions mean the same format; .md is shorter and far more common.
Can I open a Markdown file without special software?
Yes. Any text editor shows it as plain text with its marks. To see it formatted, use a Markdown viewer or a code host, or convert it to PDF.
Will tables and code blocks survive the conversion to PDF?
Yes. Tables, fenced code blocks and quotes are laid out on the page. Very wide tables are hard to read on a portrait page, so keep them to a few columns.

Other file formats

Need more than a quick fix?

AuraDoc is a document platform with OCR, AI search and summaries, and more than 60 PDF tools for teams. Try it free for 7 days.

Free tools for personal and professional use. This one runs on an isolated AuraDoc server: the file is deleted right after processing and never stored. Fair use and anti-abuse policy