Markdown Syntax Guide

Complete reference for Markdown formatting rules

Basic Syntax

Headings

Headings are created by using # symbols. The number of # determines the heading level.

# Level 1 Heading
## Level 2 Heading
### Level 3 Heading
#### Level 4 Heading
##### Level 5 Heading
###### Level 6 Heading

Paragraphs

Paragraphs are separated by blank lines. Line breaks require two spaces at the end.

This is a paragraph.

This is another paragraph.

This line ends with two spaces
This creates a line break.

Text Emphasis

Bold

**Bold with asterisks**
__Bold with underscores__

Italic

*Italic with asterisks*
_Italic with underscores_

Bold and Italic

***Bold and italic***
___Bold and italic___

Strikethrough

~~Strikethrough text~~

Lists

Unordered Lists

Use -, *, or + for unordered lists. Indent 2-4 spaces for nested items.

- Item 1
- Item 2
  - Nested item 2.1
  - Nested item 2.2
- Item 3

* Alternative syntax
* Works the same way

+ Another alternative
+ Also works

Ordered Lists

1. First item
2. Second item
3. Third item
   1. Nested item
   2. Another nested item
4. Fourth item

Task Lists

- [ ] Unchecked task
- [x] Checked task
- [ ] Another unchecked task

Links and Images

Links

[Link text](https://example.com)
[Link with title](https://example.com "Title text")

Auto-link: <https://example.com>

Reference link: [Link text][reference]
[reference]: https://example.com

Images

![Alt text](image.jpg)
![Alt text with title](image.jpg "Image title")

Reference image: ![Alt text][image-ref]
[image-ref]: image.jpg

Code

Inline Code

Use `backticks` for inline code.

Escape backticks with: ``code with ` backtick``

Code Blocks

Fenced code block:
```
Code goes here
```

With language syntax:
```javascript
function hello() {
  console.log("Hello World");
}
```

Indented code block (4 spaces):
    Code goes here
    More code

Blockquotes

> This is a blockquote
> It can span multiple lines

> Nested blockquotes
>> Use double arrows
>>> And triple for deeper nesting

Tables

| Column 1 | Column 2 | Column 3 |
|----------|----------|----------|
| Cell 1   | Cell 2   | Cell 3   |
| Cell 4   | Cell 5   | Cell 6   |

With alignment:
| Left | Center | Right |
|:-----|:------:|------:|
| L1   | C1     | R1    |
| L2   | C2     | R2    |

Horizontal Rules

Three or more hyphens:
---

Three or more asterisks:
***

Three or more underscores:
___

Escape Characters

Use backslash \\ to escape special characters:

\   backslash
`   backtick
*   asterisk
_   underscore
{}  curly braces
[]  square brackets
()  parentheses
#   hash mark
+   plus sign
-   minus sign
.   dot
!   exclamation mark