According to the official site definition. Markdown is a lightweight markup language that you can use to add formatting elements to plaintext text documents. Created by John Gruber in 2004, Markdown is now one of the worldβs most popular markup languages.
This is the basics of clear communication used in most version control and collaborative platforms such as Github.
In this post I will be giving a summary of the commonly used markdown syntax. For clarity sake, the raw format are written above and the output of the markdown are written below.
Headings are written with hashtags. One '#' is equivalent to the 'h1' in HTML syntax and so on.
# h1
## h2
### h3
#### h4
##### h5
###### h6
h1
h2
h3
h4
h5
h6
Lists
lists can be written with - or * or + sign symbols.
## Unordered list
- first time
- first time
Unordered list
first time
first time
or use:
* item 1
* item 2
* item 3
item 1
item 2
item 3
Nested list using hyphen. Always ensure you put space after the hyphen
- first time
- first time
- second time
first time
first time
second time
Progress list
- [ ] item 1
- [ ] item 2
- [ ] item
[ ] item 1
[ ] item 2
[ ] item
check list or task list
- [x] item 1
- [x] item 2
- [x] item 3
[x] item 1
[x] item 2
[x] item 3
The above list could also be written as
* [x] item 1
* [x] item 2
* [x] item 3
[x] item 1
[x] item 2
[x] item 3
Ordered list
1. item 1
2. item 2
item 1
item 2
GitHub list: Reordering occurs automatically
1. item 1
1. item 2
1. item 3
item 1
item 2
item 3
Links
[this contain the link description](this contains the actual link)
Block of codes use three surrounding back ticks used in writing specific language syntax. Ensure to put the language immediately after the backtick as shown below.