# Markdown Syntax Guide



**Markdown** is a lightweight markup language used for formatting text. One of the common places we use markdown is on GitHub Readme.md files. It can also be used  in Github gists and comments in issues and pull requests.

Therefore, this guide will be focused on the various syntax that can be used when working with Github.  

## **Syntax Guide**

- Headings
- Emphasis
- Lists
- Images
- Links
- Blockquote
- Horizontal Rule
- Code snippets
- Tables
- Task List
- Username @mentions
- Issue References
- Emoji

---

## Headings


``` shell
   # Heading 1 <h1>
   ## Heading 2 <h2>
   ### Heading 3 <h3>
   #### Heading 4 <h4>

```
   # Heading 1
   ## Heading 2 
   ### Heading 3  
   #### Heading 4 
  
---

## Emphasis
Italicised text can be written with an underscore or asterix before and after the text. 

``` shell
_Italicise this text_

*Italicise this text*
```

_Italicise this text_

*Italicise this text*


---

## Bold
Bold text can be written with a double underscore or double asterix before and after the text.

``` shell
__Make this text bold__

**Make this text bold**
```

__Make this text bold__

**Make this text bold**


---

## Lists

Lists comprises of ordered and unordered.

**Ordered**

``` shell
1. List 1
2. List 2
3. List 3
```

**Unordered**

``` shell
- List 1
- List 2
- List 3
```
*Which translates to;*
- List 1
- List 2
- List 3

---

## Images

``` shell
![Alt Text](image url)
```

![Github image](https://kinsta.com/wp-content/uploads/2018/04/what-is-github-1-1.png)

**We can also add gifs** 

![Github](https://media3.giphy.com/media/dxn6fRlTIShoeBr69N/giphy.webp?cid=ecf05e47x5e3olrkea1dbo8otmbv6jfdszorwwxyh8suldxe&rid=giphy.webp)

---

## Blockquote

``` shell
> blockquote
```

> This is a block quote!

---

## Horizontal rule

``` shell
---
```

---

## Links

``` shell
[Title](Link url)

For example:

[Giphy](https://giphy.com/)

```

- [Giphy](https://giphy.com/)


---

## Code snippets

``` shell
`code`
```

`
{
    "name": "ijae",
    "task": "eat"
}
`

---

## Tables

``` shell
  | First Header | Second Header|
    |--------------| -------------| 
    | Content Cell | Content Cell| 
    | Content Cell | Content Cell| 
  
```

![download.png](https://cdn.hashnode.com/res/hashnode/image/upload/v1600942590626/nYGTI1AfK.png)


---

## Task List

A task list comes in handy when you need to indicate progress in your issue list. This also works in pull requests.

``` shell
- [x] Indicates a complete task

- [ ] Indicates an incomplete task

```

![example.png](https://cdn.hashnode.com/res/hashnode/image/upload/v1600943104623/GTyBFPX_j.png)

---

## Username @mentions

You can type the @ symbol followed by a github username. This will notify the user.

eg @ijeomaemeruwa

---

## Emoji
Github supports the use of emoji by adding colons before and after the emoji name.

``` shell
:raised_hands: :metal: :family:
:wave: :smirk:
```

🙌 🤘 👪 👋 😏

You can find an extensive list of emojis here:

- [Webfx.com](https://www.webfx.com/tools/emoji-cheat-sheet/)

---

`Note: Take note of the spaces in each syntax`

## References

- [Github guides](https://guides.github.com/features/mastering-markdown/)

- [Markdown cheat sheet](https://www.markdownguide.org/cheat-sheet/)