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
- Text layerThe text layer is the part of a PDF that holds real characters, so you can search, select and copy. Learn how scans get one through OCR and how to check for it.
- Embedded fontsAn embedded font is stored inside the PDF so the text looks the same on every device. Learn about font subsets, missing fonts and why archives require embedding.
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.