Markdown Beginner's Tutorial

Markdown Beginner Tutorial What is Markdown?

Markdown is a lightweight markup language. It allows people to "write documents in plain text format that is easy to read and write, and then convert them into valid XHTML (or HTML) documents." Markdown is designed to facilitate the writing of the time, marking the format, while making the marked format of the plain text, compared to the HTML source, more readable.

What are the pros and cons of writing with Markdown?

Generally speaking, Markdown has the following advantages:
-syntax is simpler than HTML and can implement most HTML functions
-well-formatted, simple and intuitive, readable

What are some of the better markdown writing tools?

Because I have been using the Mac, so recommend some of the better markdown tools on the Mac, probably the following several:
-Gitbook Editor (free, powerful, first push)
-Uiysses (charge, heard very good)
-Mou (lightweight, good for Chinese support)
-Pinterest (website, native support Markdown)

In order to better demonstrate the markdown syntax, I'll take Pinterest as an example to introduce

Title

As with HTML, Markdown supports the addition of 6 levels of headings, one level title, two level title ... Level six headings, in the markdown syntax, only need to precede the corresponding level headings with the corresponding number of # symbols, it is important to note that the title and # between the best to keep a space

Horizontal Partition Line

Add three or more dashes, - asterisks, * or underscores to the line where you want to add a dash. _

Reference

Add a symbol to the front of the quote > , as the effect

Medium Dash

In the Gitbook editor directly can be used <del> 内容</del> to achieve the underlined, simple book does not support, in the simple book need *~~内容~~* to use to achieve the function of the underlined
Note: there can be no space between the symbol and the content

Italic body

Add key symbols * on both sides of the sentence you want to bold

Bold body

Sometimes when we write an article, want to highlight a word, word, sentence, then we can make it bold display, the method is to be bold in both sides of the sentence to add **

Italic Bold

If you want a word, word, or sentence to appear italic and bold, to emphasize, you can add on both sides of the***

Link

Add Link method: [link text] (link address)

Image

The method of adding a picture is similar to adding a hyperlink, except that a hyperlink is added before the method ! , and the method of adding the image is as follows
![图片名称] (图片地址)
If it is a local image how to get the image address, this is we can upload the image of the mouse into the simple book editing area, you can directly generate a picture of the link address.
Get a picture link:

To add a picture:

Unordered list

Precede the list with one * , or, or just one, + - the best space between the text and the symbol you need to notice

Ordered list

To add an ordered list, add a number and a period before the text, preferably a blank space between the text and the symbol you want to notice.

Background

To add a background to the text you just need to add an anti-quote on both sides of the text

Form

, you can set the alignment of text, Align Left: :--- , center :----: , align ----: right

code block

As a software developer, in the writing often need to add some code in the article, if the code directly pasted in the article will be very bad to see, with the help of markdown syntax can achieve a good display effect, the method is to add code in the next two lines add three anti-quotes ``` , And in the code above a line of anti-quotation marks to indicate the code introduced in what language, (alas, the ability to express, not much to say, look at the picture).

I hope you can help me, if there is a mistake, please correct me, thank you.

Markdown Beginner's Tutorial