markdown-syntax-fundamentals

# Markdown Syntax Fundamentals

Core markdown syntax for creating well-structured documents.

## Headings

```markdown
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6
```

### Heading Best Practices

- Use a single H1 (`#`) per document as the title
- Don't skip heading levels (H2 to H4)
- Keep headings concise and descriptive
- Use sentence case or title case consistently

## Text Formatting

### Emphasis

```markdown
*italic* or _italic_
**bold** or __bold__
***bold italic*** or ___bold italic___
~~strikethrough~~
```

### Inline Code

```markdown
Use `backticks` for inline code like `const x = 1`
```

## Lists

### Unordered Lists

```markdown
- Item one
- Item two
  - Nested item
  - Another nested item
- Item three

* Alternative marker
+ Also works
```

### Ordered Lists

```markdown
1. First item
2. Second item
   1. Nested numbered
   2. Another nested
3. Third item
```

### Task Lists (GitHub Flavored)

```markdown
- [x] Completed task
- [ ] Incomplete task
- [ ] Another task
```

## Links

### Basic Links

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

### Reference Links

```markdown
[Link text][reference-id]

[reference-id]: https://example.com "Optional title"
```

### Automatic Links

```markdown
<https://example.com>
<email@example.com>
```

### Internal Links (Anchors)

```markdown
[Jump to section](#section-heading)
```

Anchor IDs are auto-generated from headings:

- Lowercase
- Spaces become hyphens
- Special characters removed

## Images

### Basic Images

```markdown
![Alt text](image.png)
![Alt text](image.png "Optional title")
```

### Reference Images

```markdown
![Alt text][image-id]

[image-id]: path/to/image.png "Optional title"
```

### Linked Images

```markdown
[![Alt text](image.png)](https://example.com)
```

## Code Blocks

### Fenced Code Blocks

````markdown
```javascript
function hello() {
  console.log("Hello, World!");
}
```
````

###