---
# System prepended metadata

title: MarkDown Tutorial

---

# MarkDown Tutorial 

Markdown is a formatting code based on a simple markup language, created by John Gruber and contributed by Aaron Swartz, that allows writing simple text content that is easy to write and read, and then converting it to HTML or XHTML. It takes many instructions from the current conventions used to encode plain text in email.

    

##    1. Text
### 1.1 **Bold**
Just Put the phrase between pair of two asterisks (**) as shown below:

    **Bold**
    **this is Bold**

Result:
>**Bold**
**this is Bold**
   

### 1.2 **Italic**
Just Put the phrase between two undeserscores (_) as shown below:

    _Italic_
    _this is Itelic_
    
Result:
>_Italic_
_this is Itelic_

and i found something pretty easier:
instead of underscore you can use single asterisk (*) as shown below:

    *Italic*

Result:
>*Italic* 

### 1.3 **Mix Between Bold & Italic**
it doesn't matter which order you place the asterisks (**) or underscores (_)

    **_Mix_**
    _**this is Mix**_
    ***this is new Mix***

Result:
>**_Mix_**
_**this is Mix**_
***this is new Mix***

##    2. Headers
To make headers in Markdown, you preface the phrase with a hash mark (#).
To make Hierarchical headers insert more hash mark (#) up to 6.
    
    # header one
    ## header two
    ### header three
    #### header four

Result:
># header one
>## header two
>### header three
>#### header four

##    3. Links

### 3.1 Inline link
wrap the link text in brackets [ ], and then you wrap the link in parentheses ( )

        [Search for it.](https://www.google.com)
Result:
>[Search for it.](https://www.google.com)

you can format text of link:

        [**Search for it.**](https://www.google.com)
Result:
>[**Search for it.**](https://www.google.com)


### 3.2 Reference link
As the idea of creating variable, the value of variable is the link.
to be more easy and clean if you want to update the link.

create the reference at the bottom of your MarkDown file:

    [a fun place]: https://www.google.com
    
you can call the reference multiple times:

    Do you want to [see something fun][a fun place]?
    
Result:
>Do you want to [see something fun][a fun place]?

[a fun place]: https://www.google.com


## 4. Images
**looks like links but images are prefaced with an exclamation point ( ! ).**

### 4.1 Inline Images
images are prefaced with an exclamation point ( ! ).
wrap the discribtion text in brackets [ ], and then you wrap the image link in parentheses ( )

        ![يانهار ابيض تعلب](https://upload.wikimedia.org/wikipedia/commons/5/56/Tiger.50.jpg)
Result:
>![يانهار ابيض تعلب](https://upload.wikimedia.org/wikipedia/commons/5/56/Tiger.50.jpg)


### 4.2 Reference Images
Same as Reference link

create the reference at the bottom of your MarkDown file:

    [tiger]: https://upload.wikimedia.org/wikipedia/commons/5/56/Tiger.50.jpg
    
you can call the reference multiple times:

    ![يانهار ابيض تعلب][tiger]
    
Result:
>![يانهار ابيض تعلب][tiger]


[a fun place]: https://www.google.com
[tiger]: https://upload.wikimedia.org/wikipedia/commons/5/56/Tiger.50.jpg