DEV Community

loading...
Cover image for Mark Down for Newbies

Mark Down for Newbies

Abayomi Ogunnusi
Web developer
・Updated on ・3 min read

Written by: Abayomi Ogunnusi

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
Enter fullscreen mode Exit fullscreen mode

h1

h2

h3

h4

h5
h6

Lists

lists can be written with - or * or + sign symbols. 
## Unordered list 
- first time
- first time
Enter fullscreen mode Exit fullscreen mode

Unordered list

  • first time
  • first time
or use: 
* item 1
* item 2
* item 3
Enter fullscreen mode Exit fullscreen mode
  • item 1
  • item 2
  • item 3

Nested list using hyphen. Always ensure you put space after the hyphen

- first time
- first time
  - second time
Enter fullscreen mode Exit fullscreen mode
  • first time
  • first time
    • second time

Progress list

- [ ] item 1
- [ ] item 2
- [ ] item 
Enter fullscreen mode Exit fullscreen mode
  • [ ] item 1
  • [ ] item 2
  • [ ] item

check list or task list

- [x] item 1
- [x] item 2
- [x] item 3
Enter fullscreen mode Exit fullscreen mode
  • [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
Enter fullscreen mode Exit fullscreen mode
  • [x] item 1
  • [x] item 2
  • [x] item 3

Ordered list

1. item 1
2. item 2
Enter fullscreen mode Exit fullscreen mode
  1. item 1
  2. item 2

GitHub list: Reordering occurs automatically

1. item 1
1. item 2
1. item 3
Enter fullscreen mode Exit fullscreen mode
  1. item 1
  2. item 2
  3. item 3

Links

[this contain the link description](this contains the actual link)
Enter fullscreen mode Exit fullscreen mode

HOMEPAGE

Links with title

[this contain the link description](this contains the actual link "this contains the link alt text")
Enter fullscreen mode Exit fullscreen mode

web glance

Inline code using the backtick

this is an inline `code`
Enter fullscreen mode Exit fullscreen mode

this is an inline code

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.

<p> a paragraph example</p>
Enter fullscreen mode Exit fullscreen mode
<p> a paragraph example</p>
Enter fullscreen mode Exit fullscreen mode
let table = 3;
Enter fullscreen mode Exit fullscreen mode

Before and after results using block quotes

Before

console.log('test')
Enter fullscreen mode Exit fullscreen mode

after

console.log('new test')
Enter fullscreen mode Exit fullscreen mode

the above code block can be re-written as :

-console.log('test`)
+console.log('new test`)
console.log('neutral')
Enter fullscreen mode Exit fullscreen mode

diff
-console.log('test)
+console.log('new test
)
console.log('neutral')

Block quotes

> this is a block quote
Enter fullscreen mode Exit fullscreen mode

this is a block quote

Adding pictures

![image](http://picsum.photos/200/200)
![purple markdown icon](http://markdown-here.com/img/icon256.png)
Enter fullscreen mode Exit fullscreen mode

image
purple markdown icon

Emphasis (strong)

this is a bold **text**
or __bold__
Enter fullscreen mode Exit fullscreen mode

this is a bold text
or bold

Emphasis (italics)

This is an *italics*
or 
_italics_
Enter fullscreen mode Exit fullscreen mode

This is an italics
or
italics

Writing language syntax using markdown

function add(a,b){
return a + b;
Enter fullscreen mode Exit fullscreen mode

Tables

| User | Email  |
| --- | --- |
| abayomi | abayomiogunnusi@gmail.com |
| isreal | isreal@gmail.com |
Enter fullscreen mode Exit fullscreen mode
User Email
abayomi abayomiogunnusi@gmail.com
isreal isreal@gmail.com

Tables

Frond-End Back-End Full Stack
HTML, CSS, JS NODE JS, MONGODB HTML, MONGODB,...
REACT, BOOTSTRAP EXPRESS, MONGOOSE DOCKER

strike through is achieved using ~~ ~~

~~strike~~
Enter fullscreen mode Exit fullscreen mode

strike

Checklist

- [ ] abayomi
- [ ] abayomi
- [ ] abayomi
- [ ] abayomi
- [x] abayomi
Enter fullscreen mode Exit fullscreen mode
  • [ ] abayomi
  • [ ] abayomi
  • [ ] abayomi
  • [ ] abayomi
  • [x] abayomi

Tag people use the '@' symbol

@wowzone

@deenn
@drsimplegraffiti

GitHub logo drsimplegraffiti / drsimplegraffiti

Config files for my GitHub profile.

Calm Developer

Hi πŸ‘‹, I'm Abayomi

A passionate Web developer from Nigeria

drsimplegraffiti

drsimplegraffiti

drsimplegraffi1

  • 🌱 I’m currently learning Backend Node Js

Connect with me:

drsimplegraffiti drsimplegraffi1 15661401 drsimplegraffiti @drsimplegraffiti

Languages and Tools:

bootstrap css3 express git heroku html5 illustrator javascript mongodb nodejs photoshop postman react sass xd materialize mocha

Support:

drsimplegraffiti



drsimplegraffiti

Β drsimplegraffiti

drsimplegraffiti

Dev.to Post

πŸ”— Improve your Github Profile

πŸ”— Download Browser Page as PDF

πŸ”— Send mails using NodeJS

πŸ”— Chat App using Socket.io

Discussion (0)