Markdown
Markdown (noun) means a lightweight way of formatting plain text using ordinary keyboard characters, so that asterisks around a word make it bold, a hash at the start of a line makes it a heading, and so on. The file stays readable as it is, and software can turn it into formatted output such as a web page. Example: “The README is written in Markdown.”
How to Use Markdown
Learner’s notesIn plain EnglishA simple way of typing formatting, like putting stars round a word to make it bold.
Capitalised as Markdown when naming the format. The retail sense is an ordinary lower-case noun and unrelated in meaning.
Note the deliberate joke in the name: markup goes up, Markdown goes down.
Trace the full origin ↓Fill the Gap
Can you complete this real example?
The README is written in _____.
Etymology
Named by John Gruber in 2004 as a play on markup, the general term for adding formatting instructions to plain text.
Synonyms
View more →Antonyms
Related Words
Frequently Asked Questions
What is the difference between Markdown and HTML?
Both describe how text should be formatted, but HTML uses explicit tags and can express almost any layout, while Markdown offers a small set of shorthand characters covering the common cases: headings, bold, italics, lists, links and code. Markdown is normally converted into HTML behind the scenes, and most versions let you drop raw HTML in when you need something Markdown cannot express.
Is Markdown a programming language?
No. It gives no instructions and performs no calculations. It is a markup syntax: a way of annotating plain text to say which parts are headings, emphasis, lists or links.
Why are there so many versions of Markdown?
The original 2004 description left a number of cases ambiguous, so different projects filled the gaps in different ways and added their own extras, such as tables and task lists. CommonMark is a later effort to pin the core rules down precisely, and GitHub Flavored Markdown is a widely used extension of it.