What is Markdown?
Markdown is a lightweight markup language created by John Gruber in 2004 for formatting plain text documents. It uses simple, intuitive syntax that can be easily converted to HTML and other formats while remaining readable in its raw form.
Quick Facts
| Full Name | Markdown Markup Language |
|---|---|
| Created | 2004 by John Gruber and Aaron Swartz |
| Specification | Official Specification |
How Markdown Works
Markdown was designed to be as readable as possible in its source form. It uses punctuation characters like asterisks, underscores, and hash symbols to indicate formatting such as bold, italic, headers, and lists. The language has become the de facto standard for documentation, README files, and content management systems. Various flavors exist including CommonMark, GitHub Flavored Markdown (GFM), and MultiMarkdown, each adding extensions like tables, task lists, and syntax highlighting.
Key Characteristics
- Plain text format readable without rendering
- Simple syntax using common punctuation characters
- Easily converts to HTML and other formats
- Supports headers, lists, links, images, and code blocks
- Multiple flavors with extended features (GFM, CommonMark)
- Widely supported by editors, platforms, and static site generators
Common Use Cases
- Writing README files and documentation
- Creating blog posts and articles
- Note-taking applications
- Static site generators (Jekyll, Hugo, Gatsby)
- Collaborative writing platforms (GitHub, GitLab)
Example
# Heading 1
## Heading 2
**Bold text** and *italic text*
- Unordered list item
- Another item
1. Ordered list
2. Second item
[Link text](https://example.com)
`inline code`
```javascript
const greeting = 'Hello';
```
> Blockquote text
| Column 1 | Column 2 |
|----------|----------|
| Cell 1 | Cell 2 |