markdown--Getting Started Guide

by Te_lee Reprint please indicate the original author

Lead:

Markdown is a lightweight "markup Language", which has many advantages and is now widely used by writers who are more and more writing enthusiasts. See here Please do not be confused by "Mark","language" , Markdown syntax is very simple. There are no more than 10 commonly used marker symbols, this is a very lightweight, less expensive, learning-cost Markdown than a more complex HTML markup language, and once you get familiar with this grammar rule, it will work once and for all.

First, know Markdown

As mentioned in the introductory note, Markdown is a lightweight "markup Language"for writing, which replaces typography with concise syntax, rather than the word-processing software we use. word or Pages has a lot of typography and font settings. It allows us to focus on the code word and use the "tag" syntax instead of the common typesetting format. For example, from the content to the format, and even illustrations, the keyboard can be all done. Currently, there are many editors that support Markdown syntax, including many websites (such as Pinterest) that support Markdown text entry. Markdown from writing to completion, export format as you like, you can export HTML format files for the site publishing, can also be very convenient to export PDF format, this format of the resume can be more favorable to HR. You can even use CloudApp, a cloud service tool, to upload directly to a Web page to share your articles, the world's largest lightweight blogging platform, TUMBLR, and support the direct uploading of Markdown tools such as the Mou.

Markdown Official documents

Here you can see the official Markdown Grammar rules document, and, of course, I will use my own way to illustrate the specific use of these grammars .

• Founder John Gruber's Markdown grammar description
• Markdown Chinese Version Grammar description

Advantages of using Markdown

• Focus on your text rather than your typography and write with confidence.
• Easily export HTML, PDF, and your own. md files.
• Plain text content, compatible with all text editors and word processing software.
• Modify your article version at any time without causing confusion like a word processing software generation of several file versions.
• Readable, intuitive, low-cost learning.

Mistakes in using Markdown

We believe that writing are about content and about what you want to say–not about fancy formatting.
We believe that writing is about content, thinking, not pattern.
- Ulysses for Mac

• Markdown is designed to be concise and efficient, but also because of Markdown's easy-to-read and easy-to-write, people in different programming languages to implement multiple versions of the parser and generator, which led to the current different Markdown tools integrate different functions (basic functions are roughly the same), such as flowchart and timing diagram, Complex tables and complex formulas, although the rich features and there is no essential shortcomings, but eventually some deviate from the original intention, not to mention in the process of writing is very difficult, rather than using professional tools to write more efficient, so if you need to implement complex functions, professional graphical interface tools will be more convenient. Of course, if you're happy with the high-level features of these different clients ' customizations to Markdown, it's understandable.

What tools should I use?

• On Mac OS X, I highly recommend that you use the Mou free and very useful Markdown editor, which supports real-time preview , on the left you edit the Markdown language, the right side will be generated in real-time preview effect. Moreover, the Mou has some interesting preferences (Preference), such as themes (Themes) and styles (CSS), which can be configured to customize the effects of text editing and exporting, If you're not happy with your own theme and style, you can search for more themed styles written by other enthusiasts for the Mou on GitHub, and you can choose reload in the Themes or CSS options of your preferences.

Mou Writing and Preview window

If you work in writing, I strongly recommend that you buy Ulysses for Mac, which is the best of the Apple Mac App Store. It supports more writing formats, multi-document support. Mou,ia writer These software are based on the management of single documents, and Ulysses support Folder, Filter management, a folder can be created within a plurality of sheet,sheet can also be Combine processing.

Some Markdown editors on Mac

• Because I rarely contact windows,windows under the Markdown not too much to dabble, by friends, there are two is still good, a section called Markdownpad, another is called Markpad.

• Many apps on iOS have already supported Markdown input, such as Drafts,day One,ia writer, and Ulysses for IPad is now on the shelves, which is the best editor on the iOS platform.

• On the web side, I strongly recommend the simple book this product, there are countless love words of people in the endless creation, sharing. The use of Markdown on the Web side is no more comfortable than a simple book, the same support for the left and right two columns of real-time preview, elegant fonts, concise.

Second, the brief rule title of the Markdown grammar
Title

The title is the most commonly used format for every article, and in Markdown, if a piece of text is defined as a title, just add the number before the text # .

# 一级标题

## 二级标题

### 三级标题

And so on, a total of six levels of title, it is recommended to add a space after the pound, this is the most standard Markdown syntax.

List

Familiar with the HTML of the classmate must know that there is a sequence table and unordered list of differences, under Markdown, the list of the display only need to be in front of the text - or * can become an unordered list, the sequence list directly before the text is added 1. 2. 3. A space in which to add a character between the symbol and the text.

Unordered list and ordered list reference

If you need to refer to a small section of a sentence elsewhere, then use the quoted format.

such as this

Just add > this angle bracket (greater than sign) before the text to

Reference pictures and Links

The insert link is much like the syntax for inserting a picture, the difference between a ! number

The picture is:![](){ImgCap}{/ImgCap}

Links to:[]()

Insert image of the address needs a bed, here is recommended to repair plan bed and CloudApp service, generate URL address.

URL and picture Bold and italic

Markdown Bold and italic are also very simple, with two * contains a paragraph of text is the syntax of bold, with a * paragraph containing a text is italic syntax.

For example: here is the bold body here is Italic

Form

The form is where I find the Markdown more tiring, as in the following examples:

| Tables        | Are           | Cool  || ------------- |:-------------:| -----:|| col 3 is      | right-aligned | $1600 || col 2 is      | centered      |   $12 || zebra stripes | are neat      |    $1 |

This syntax generates the following table:

is

Tables		Cool
Col 3 is	right-aligned	$1600
Col 2 is	Centered	$
Zebra Stripes	Is neat	$

Code box

If you are a program ape, you need the elegant reference Code box in the article, the implementation under the markdown is very simple, only need to use two ' to wrap up the middle code. Legend:

Use the tab key to indent.

Split Line

The syntax for a split line requires only three * numbers, for example:

Here, Markdown Basic Grammar in the daily use of the basic is no big problem, as long as more practice, with good tools, writing things will certainly be flowing. More grammar rules, in fact the MOU's Help document chestnut is very good, when you first use the MOU, the document will be displayed. Can be used to find and learn to use.

markdown--Getting Started Guide