ULOG # 1: Markdown 101 - Creating this first blog

Introduction


Finally! A while back, a friend asked me how to do blockquotes using the SteemIt editor since I do have background using Markdowns. I haven't really explored the editor, in fact I haven't posted a blog yet. I did some experimenting and compiled them, hence, this blog. Hope this could help others starting out without much background in using HTML or Markdown.

Before you start, here's a cute husky to motivate you!

Cute Husky
(Disclaimer: Credits to the owner for this awfully cute photo.)

What exactly is Markdown?


Basically, Markdown is the thing you put to the text of your content to make it look nicer and easier to read. Instead of writing stuff like <h3> Hi! I'm awesome!</h3>, you would only have to write #Hi! I'm awesome which produces the same thing. You won't bother yourself writing those greater-than and less-than signs which will surely make yourself miserable if you're not familiar with HTML.

Here are some things you might want to remember.

Headers

Use headers to define sections of your content. You can use six different headers by starting the text with at most six number signs (#) followed by a space.

# Largest header
## Slightly large header
...
##### Slightly small header
###### Smallest header

RESULT:

Largest header

Slightly large header

...

Slightly small header
Smallest header


(Do not forget the space after the number signs, or else it will be treated as a plain hashtag.)

You may also use === for H1 or --- for H2 alternatively but I do suggest you use # and ## to make it more readable and distinct.


Largest header
===

Slightly large header
---

RESULT:

Largest header

Slightly large header


(Don't forget to have a new line/line break before the header text when using --- and === or else it wouldn't work.)


Emphasis

Emphasizing words or phrases helps your readers remember points about your blog. You can bold or italicize using *.

You can **bold** or *italicize* your text.  
You might also want to put ~~strikethroughs~~. 
You can even ***combine*** ~~**them**~~.

RESULT:
You can bold or italicize your text.
You might also want to put strikethroughs.
You can even combine them.

(Do not leave spaces before and after your text.)


Blockquotes

You might want to quote something in your blog to refer someone or something. You can also use quotes to indicate replies. You'll probably know this if you use forums like Reddit.

You can do this by adding a > and a space before your text. You can also nest them as shown below. However, note that you need to have a new line to break the quote.

> This a quote
Quoted the same as above.
>> Quote again
Like I said.
>>> Another quote
This would still be quoted even though there is no >
This also.

This wouldn't be

RESULT:

This a quote
Quoted the same as above.

Quote again
Like I said.

Another quote
This would still be quoted even though there is no >

This wouldn't be


Links and Images

You can use links to create shortcuts or references to your previous blogs or an external website. You can do this by enclosing your text with [] followed by the link and/or tool tip (the tiny box with a text you see when you hover the text) enclosed in parenthesis ()

[The whole text has the link.](https://www.google.com)
I just want the [link](https://www.google.com) word to have the link.

RESULT:
The whole text has the link.
I just want the link word to have the link.

Images also work the same as other links. All you need to do is start the link with ! and the text as the alternative in case your image has problems loading.

![Cute Husky from Google](http://s3.amazonaws.com/files.wdaily.ca/styles/content_primary_image/s3/fluffyhusky1.jpg?itok=D37laG6A)

![Here's the Husky Again but the link doesn't work](http://somerandomlink.com/notavalidimagepathorlink.jpg)

RESULT:
Cute Husky from Google

Here's the Husky Again but the link doesn't work

(Basically, the syntax for links would be something like [Link Text or Alternative Text](Link). Don't forget the ! if you're linking an image. Be careful not to put a space between[] and (). Trust me, this mistake is very common.)


Horizontal Rule and Line Breaks

Basically you can add this gray line by adding three - on a line.

---

RESULT:


(You should not have any text directly preceding the --- or else it would be rendered as a header. )

You can just press Enter to put a line break. However, if you want to put many line breaks, you have to put \ to 'escape' the Enter character or else it would just be omitted as shown below. (Please do help me explain this 'escape' thingy in the comments.

Hello
Hello



Hello
\
\
\
\
Hello

RESULT:
Hello
Hello

Hello




Hello


Code Blocks

This is what I've used to show you how the text looks like before it is rendered. Anything enclosed in this block will not be rendered and will just be plain text or code as you can see in a text editor.

You can use this by enclosing your text or code in two ``` tags. I added \ to prevent it from being rendered for example purposes.

\```
# Markdown here and there
Some random text over here!
> A quote...
\```

RESULT:

# Markdown here and there
Some random text over here!
> A quote...

Tables

You can also make tables. It's just harder than the thing you do in a word processor but trust me, it's way easier than writing HTML yourself. You can use | to define the columns. You can define the alignment of the whole column content by placing a : on the left or right as shown below.

| HEADER 1      | HEADER 2       | HEADER 3        |
| ------------- | :------------- | --------------: |
| Item 1        | left-aligned   |  right-aligned  |
| **Item 2**    | *italicized*   |  ~~***more***~~ |
| Item 1        | left-aligned   |  right-aligned  |

RESULT:

HEADER 1HEADER 2HEADER 3
Item 1left-alignedright-aligned
Item 2italicizedmore
Item 1left-alignedright-aligned

(Take note that you can only assign the alignment of the column after the column header. You can also omit the outer | and it will still render the same.)


Lists

You might even use this if you're blogging recipes or instructional stuff. This is better understood by looking at the example below.

Numbered List
1. Item 1
2. Item 2
Some description or text for Item 2. This is automatically indented
6. Item with wrong number will still have the right number when rendered
1. Item with another wrong number

Unnumbered List
+ Item 1
+ Item 2
+ Item 3

RESULT:
Numbered List

  1. Item 1
  2. Item 2
    Some description or text for Item 2. This is automatically indented
  3. Item with wrong number will still have the right number when rendered
  4. Item with another wrong number

Unnumbered List

  • Item 1
  • Item 2
  • Item 3

(You may opt to use - or * for unnumbered lists but I do suggest you use + for consistency. Let's leave the - for the horizontal rule and the * for the emphasis thingy.)



Conclusion

You need to explore these things yourself to know how will they actually behave. I might not have included other errors/mistakes you should avoid but it's okay, the fun lies in discovering and experiencing them firsthand. Please do comment anything I have missed out or any other thing you might want to share or ask. Hopefully, I'll be sharing tips using HTML together with this Markdown on my next blog.

H2
H3
H4
3 columns
2 columns
1 column
Join the conversation now
Logo
Center