Markdown Essentials
Tags: python
Published: 2020-01-09 05:25:51

My first post was necessary, otherwise no half pretty posts haha. I would appreciate if anybody could recommend how they resize their images to follow the cover image dimensions. 

# Markdown Language

## Overview  
It is a lightweight markup language like HTML (No Tags) with a plain formatting syntax. The ease of use and readability are seen as its main advantages. 

Markdown keeps positioning and uses special characters/punctuation marks to format stuff like **bold**, _italics_, lists etc.

**_Uses_**
* It can be converted into HTML/XHTML
* Use with README.md files (Github etc, Documentation on a Repo page)
* Forums & Blogs (Pieces of content)
* Static Site Generators (Gatsby that uses React framework)

|Core Markdown  |                |
|------------------|:------------:|
|Headings          |Lists|
|Block of code     |Images|
|Emphasis          |Block-quotes|
|Links(Inline & Reference)|Horizontal rules|
|Paragraphs|Code & Syntax highlighting|

***_Extras_***

* Extensions allow for extra functionality with using markdown, like GitHub has extra extensions that allow for tables and task lists to be generated.
* Text Editors have extensions that allow for you to preview the markdown file you have generated (VSCode (Auto-Open Markdown Preview), Atom, SublimeText etc.)

###Basics
####Italics

Single (Asterisks or Underscore)

```
_italics_
```

_italics_

####Emphasis

Double (Asterisks or Underscore)

```
**Bold**
```

**bold boy**

####Strikethrough

Double Tilda

```
~~Computer says NO!~~
```

~~Computer says NO!~~

####Horizontal rule (line) 

Triple underscore, hyphens or underscores

```
---

```
---

Add double tildas to get two Horizontal rules, aligned to the left, shortened also so may be used for sub section breakup. Good to know (My Mistake found it, sweet!)

~~____________________________________~~

####Escape special characters, 

Allows you to include them as normal in your document, see below how I used the \ escape character to include the HTML tag in the header section.


###Headers

Like headers in HTML (**# = \</h1> tag**)
``` 
#header one
## header two
### header three
#### header four
##### header five
###### header six
```

#header one
## header two
### header three
#### header four
##### header five
###### header six

###links (Inline & Reference) 

####Inline Link

Square brackets & Curly parentheses
\[Text for link](link itself, "Title"(Optional, for hovering over purposes(**Doesn't seem to work here, if someone has a solution let me know**))

```
[My GitHub](https://github.com/turbodaly152 "GitHub Profile")

[**My LinkedIn**](https://www.linkedin.com/in/eoin-vaughan-6a929aa5/ "Eoin Vaughan LinkedIn Profile")
```
[My GitHub](https://github.com/turbodaly152 "Eoin Vaughan GitHub Profile")

[**My LinkedIn**](https://www.linkedin.com/in/eoin-vaughan-6a929aa5/ "Eoin Vaughan LinkedIn Profile")

####Reference Link

Place the reference at the bottom of the document(hidden), very useful if you want to use the same link a few times in a markdown doc.

```
Click here for [BC Parks][BCParks]

\[BCParks]: http://www.env.gov.bc.ca/bcparks/ (Will be hidden, only visible in source markdown code)

```

Click here for [BC Parks][BCParks]

[BCParks]: http://www.env.gov.bc.ca/bcparks/

###Images(Inline & Reference)

####Inline Image

Exclamation mark !

```
![Image of the price of Babybel here in Vancouver, Crazy](https://photos.google.com/photo/AF1QipNu6mpDnJNiMfNvAQGm5xHXuIRoxmcV3ucHvgr3)
```

![Image of the price of Babybel here in Vancouver, Crazy](https://photos.google.com/photo/AF1QipNu6mpDnJNiMfNvAQGm5xHXuIRoxmcV3ucHvgr3)

####Reference Image

```
![Sea the stars][Best horse ever]
![Frankel][Second best horse ever]

\[Best horse ever]:https://tuesdayshorse.files.wordpress.com/2009/10/seathestars.jpg

\[Second best horse ever]: https://images.ctfassets.net/5v3ask2aw4ox/PA-2.11282730/ff78659756ed4b284288ef544f5a727d/2.11282730.jpg
```
![Sea the stars][Best horse ever]
![Frankel][Second best horse ever]

[Best horse ever]:https://tuesdayshorse.files.wordpress.com/2009/10/seathestars.jpg

[Second best horse ever]: https://images.ctfassets.net/5v3ask2aw4ox/PA-2.11282730/ff78659756ed4b284288ef544f5a727d/2.11282730.jpg

###Block-quotes

Use of carat character \> results in a highlighted background with a border to the left of the block-quote

```
>"To infinity and beyond" Buzz Lightyear
```

>"To infinity and beyond" Buzz Lightyear

####Span multiple paragraphs, Block-quotes

```
>Hello to you
>And goodbye
>to you
```
>Hello to you
>And goodbye
>to you

###Lists (Ordered and Unordered)

Use asterisk (with space) for unordered lists 
**AND** 
\1. for ordered lists

```
* Chocolate fingers
* Chocolate buttons
* Chocolate digestives
```

* Chocolate fingers
* Chocolate buttons
* Chocolate digestives

```
1. Chocolate fingers
1. Chocolate buttons
1. Chocolate digestives
```
1. Chocolate fingers
1. Chocolate buttons
1. Chocolate digestives

Can use indentation to have nested list items, **must find out how to make indentation default to 1.1, 1,2, 1.1.2 etc.?**

```
1. Chocolate fingers
 1. Chocolate buttons
1. Chocolate digestives
```
1. Chocolate fingers
 1. Chocolate buttons
1. Chocolate digestives

* Chocolate fingers
 * Chocolate buttons
* Chocolate digestives

To include text within a bulletpoint  you may include it underneath with 2 indentations

```
* Chocolate fingers

* Chocolate buttons
* Chocolate digestives