A Flow of Thoughts

Markdown Tutorial

Posted on

Introduction

Markdown is a tool that can transfer plain text to HTML. It’s often used by bloggers to effectively write and format a post. One of the key traits of Markdown is its easiness and directness. Users do not need to spend much time on learning the syntax, yet can generate high-quality posts.
Here is my note for Markdown. Hope you find it useful.

Download Markdown Editor

I use sublime text three as my markdown editor. It’s free, and it supports other languages as well. However, I do not recommend it for it is not realtime display. It’s suitable for programmers and who are confident enough about their code.

Markdown Pad is a well-known editor. It has realtime display and all the other features you needed.

Basic Syntax

After choosing your markdown editor, you can begin to keep some notes following this tutorial using markdown.

Passage:

There is no special markdown syntax for pssages. What you type is what you get.

Headings:

1
2
# This is the first level heading 
## This is the second level heading

Level here means different size of the heading. First level is the biggest one. It also suggests the logic connection between each headings and passages. Second Level heading belongs to the first level heading above it. Third Level heading belongs to the second level heading above it. However, you can directly use second level heading without the usage of the first level heading.
Notice that there is a _space_ behind the ## symbol. This is true for _all_ markdown syntax. Be careful.

Lists:

1
2
3
4
* You can 
* Create an
* un ordered list
* by using *
  • this is
  • what an
  • unordered list looks like
1
2
3
1. And you can
2. create an ordered list
3. by directly adding number like this.
  1. This is
  2. an ordered
  3. list

Emphasized Text

1
2
using *asterisks* can emphasize 
using _underscore_ can do the same

Here is asterisks
Here is _underscore_
Double the amount of symbols on both sides can strength your emphasis.
Here is an example
Doubling underscores can work as well

1
This is a [link](https://alexsixdegrees.github.io/) to my homepage.

This is the link.

Images

Images are tricker. They need a litte more steps than the others.

1
![your alteration text for images](the link of the image.png "Title")

Sometimes it’s hard for the beginners to get the relative path of the image correct (myself included). As a result, we can use others’ help.
I use a website called 极简图床. What you need to do is just dragging the images on to the website, and it would save and cite it for you. The thing is it’s a Chinese website…
There are some similar services online. I am sure you can find it.

Code

Using Markdown to show code is easy by simply wrapping your code with back quote(`).

Cite

1
2
> Quote
> <cite>the author</cite>

Division Line

1
***

For More Detail

These are some basic ways of writing markdown. I used them all the time during my work.
Check out my Markdown Series to learn more about using Markdown within your Blog.
For more detail, you can also visit Markdown Document. They have a much more complege and sophisticated tutorial for you.