Markdown is a way of writing formatted text using plain characters. It was created by John Gruber, with Aaron Swartz, in 2004 with the goal that a Markdown file should be readable as-is, even before it is converted to HTML. It is now used for README files, documentation, forums, note-taking apps and chat.
Core syntax
# Heading 1
## Heading 2
A paragraph is one or more lines of text.
A blank line starts a new paragraph.
*italic* or _italic_
**bold** or __bold__
`inline code`
- A bullet list
- Another item
- Indented items make a nested list
1. A numbered list
2. Second item
[Link text](https://example.com)

> A block quote
---
Fenced code blocks use three backticks (or tildes) on the lines before and after the code. Many tools accept a language name after the opening fence (```js) for syntax highlighting.
Line breaks
A single line break inside a paragraph is ignored when rendered; the lines flow together. To force a break, end the line with two spaces or a backslash. To start a new paragraph, leave a blank line.
Extensions you will often see
The original description left many details open, which led to different implementations. CommonMark is a precise specification that most modern tools follow. GitHub Flavored Markdown (GFM) adds:
- tables with
|pipes and a---separator row; strikethroughwith double tildes;- task lists with
- [ ]and- [x]; - automatic links for bare URLs.
| Tool | Purpose |
|:-----|--------:|
| wc | counts |
Colons in the separator row set alignment: left, right, or both sides for centered.
Raw HTML
Standard Markdown allows HTML mixed into the text. That is convenient but risky when displaying Markdown from others, so many platforms strip or sanitize it. The Markdown Previewer treats raw HTML as plain text and never runs scripts.
Tips
- Leave a blank line before and after lists, headings and code blocks; it avoids most rendering surprises.
- Use one heading 1 per document.
- Preview before publishing; flavors differ in edge cases such as nested lists and underscores inside words.