Markdown Cheatsheet for Developers
August 17, 2026
- Markdown
Markdown Cheatsheet for Developers
Markdown's whole pitch is that it's readable even before it's rendered. Here's the syntax that covers most of what you'll write in READMEs, docs, and blog posts like this one.
Headings and emphasis
# Heading 1
## Heading 2
### Heading 3
**bold**, *italic*, ~~strikethrough~~, `inline code`Lists
- Unordered item
- Another item
- Nested item
1. Ordered item
2. Another itemLinks and images
[link text](https://example.com)
The only difference between the two is the leading ! — an image is a
link with an exclamation mark in front.
Code blocks
Fenced code blocks take a language identifier right after the opening triple backtick, which is what enables syntax highlighting:
```javascript
const greeting = 'hello';
console.log(greeting);
```Tables (GitHub-flavored)
| Syntax | Result |
| -------- | -------- |
| `**a**` | **a** |
| `*a*` | *a* |Alignment is controlled with colons in the separator row:
| Left | Center | Right |
| :--- | :----: | ----: |
| a | b | c |Blockquotes
> Markdown was created by John Gruber and Aaron Swartz in 2004.Task lists
GitHub-flavored Markdown also supports checkboxes, handy for tracking progress directly in a file:
- [x] Write the draft
- [ ] Add code examples
- [ ] PublishHorizontal rule
---Three or more hyphens (or asterisks, or underscores) on their own line renders as a divider — this same syntax is also what separates frontmatter from content at the top of a post.
What's not standard
Things like footnotes, definition lists, and embedded HTML components vary by renderer. If a feature isn't listed here, check what flavor of Markdown your tool actually implements before relying on it.