of Markdown syntax, organized by category.
1. Headers
# H1
## H2
### H3
#### H4
##### H5
###### H6
Alternative syntax (H1/H2 only):
H1 Header
=========
H2 Header
---------
2. Text Formatting
| Syntax | Result |
|---|
*italic* or _italic_ | italic |
**bold** or __bold__ | bold |
***bold italic*** | bold italic |
~~strikethrough~~ | strikethrough |
`inline code` | inline code |
3. Lists
Unordered:
- Item 1
- Item 2
- Nested item
* Item (asterisk also works)
+ Item (plus also works)
Ordered:
1. First item
2. Second item
1. Nested item
3. Third item
Task lists (GFM extension):
- [x] Completed task
- [ ] Incomplete task
4. Links
[Link text](https://example.com)
[Link with title](https://example.com "Title text")
<https://example.com> (auto-link)
[Reference link][1]
[1]: https://example.com (reference definition)
5. Images


6. Code Blocks
Fenced code block (recommended):
```python
def hello():
print("Hello, world!")
```
Indented code block (4 spaces):
def hello():
print("Hello, world!")
7. Blockquotes
> This is a blockquote
>> Nested blockquote
> Multiple lines
> in same quote
8. Horizontal Rules
---
***
___
(All three produce identical horizontal lines)
9. Tables (GFM extension)
| Header 1 | Header 2 | Header 3 |
|----------|:--------:|---------:|
| Left | Center | Right |
| aligned | aligned | aligned |
Alignment markers:
:--- = left align:---: = center align---: = right align
10. Escaping Characters
\* Not italic \*
\# Not a header
\[Not a link\]
Use backslash before: \ ` * _ { } [ ] ( ) # + - . !
11. Line Breaks
End line with two spaces
for a line break (no new paragraph)
Blank line
for a new paragraph
12. Footnotes (Extension, not universally supported)
Here's a sentence with a footnote.[^1]
[^1]: This is the footnote content.
13. Definition Lists (Extension)
Term
: Definition 1
: Definition 2
14. GitHub-Specific Extensions
Mentions:
@username
Issue/PR references:
#123
Emoji:
:smile: :heart: :thumbsup:
Syntax highlighting (language-specific):
```javascript
```
```bash
```
```json
```
15. HTML Embedding
Most Markdown flavors allow raw HTML:
Centered content
(manual line break)
<sub>subscript</sub>
<sup>superscript</sup>
Quick Reference Table
| Element | Syntax |
|---|
| Header | # H1 |
| Bold | **text** |
| Italic | *text* |
| Strikethrough | ~~text~~ |
| Link | [text](url) |
| Image |  |
| Code | `code` |
| Code block | ``lang ` |
| Blockquote | > text |
| List (unordered) | - item |
| List (ordered) | 1. item |
| Horizontal rule | --- |
| Table | | col | |
| Task list | `- [ |
[...truncated: increase max_tokens...]