# Learning Markdown

*Markdown is a lightweight markup language for creating formatted text using a plain-text editor.*

---

## The Basics

Rather than using a language like HTML or XML with bracket syntax, Markdown provides an easy way to write quickly formatted documents without complicated tags. Most commonly we see Markdown used in, README files on GitHub, static site generators, blog posts or wikis, and documentation or note-taking tools.

### Syntax

**Headers:**
```markdown
# H1 - Main title
## H2 - Section title
### H3 - Subsection
```

**Emphasis:**
```markdown
*italic* or _italic_
**bold** or __bold__
~~strikethrough~~
```

**Lists:**
```markdown
- this is 
- an 
- unordered list
```

```markdown
1. This is 
2.  an 
3. ordered list
```

**Links:**
```markdown
[Link](https://link.com)
```
**Images:**
```markdown
![Alt text](image location or url)
```

**Inline code:**
```markdown
Use `ls -la` to list files.
```

**Code block:**
```html
```bash
echo "Hello, world!"
```

**Blockquotes:**
```markdown
> This is a quote.
>> This is a nested quote.
```

**Horizontal Rule:**
```markdown
---
or
***
```

**Tables:**
```markdown
|Name |Role   |
|-----|-------|
|Chloe|Intern |
```

**Task Lists:**
```markdown
- [x] Learn Markdown
- [ ] Finish documentation
```

---
## Resources
- [Markdown Guide](https://www.markdownguide.org/) free and open-source reference guide that explains how to use Markdown
- [Markdown Practice](https://dillinger.io/) write markdown on the left and see the formatted output on the right
- [Pandoc](https://pandoc.org/) a tool to convert files from one markup language into another