Markdown入门语法整理

说明：此文档只涉及Markdown相关基础知识，不对HTML语法进行解释

1.标题

1.1 类Setext形式

类 Setext 形式是用底线的形式，利用 = （最高阶标题）和 - （第二阶标题），例如：

This is an H1
=============

This is an H2

-------------

1.2 类Atx 形式

# 这是 H1

## 这是 H2

###### 这是 H6

　　可以在行尾加上 #，而行尾的 # 数量也不用和开头一样（行首的井字符数量决定标题的阶数）：

# 这是 H1 #

## 这是 H2 ##

### 这是 H3 ######

2.列表

2.1    '- '      '+ '      '1. ' 都行

- 文本1
- 文本2
- 文本3

2.2 如果要求序列化

1. 文本1
2. 文本2

3. 文本3

　　列表项目可以包含多个段落，每个项目下的段落都必须缩进 4 个空格或是 1 个制表符:

* This is a list item with two paragraphs.

  This is the second paragraph in the list item. You're

only required to indent the first line. Lorem ipsum dolor

sit amet, consectetuer adipiscing elit.

* Another item in the same list.

如果要在列表项目内放进引用，那 > 就需要缩进：

* A list item with a blockquote:

  > This is a blockquote

  > inside a list item.

3.链接和图片

[简书](http://www.jianshu.com）#插入链接

<http://example.com/>#自动链接

<[e-mail]>#邮箱地址链接

！[]http://upload-images.jianshu.io/upload_images/259-0ad0d0bfc1c608b6.jpg?#插入图片

4.引用

前面加>就可以，以空行结束引用

> 一盏灯， 一片昏黄； 一简书， 一杯淡茶。 守着那一份淡定， 品读属于自己的寂寞。 保持淡定， 才能欣赏到最美丽的风景！ 保持淡定， 人生从此不再寂

区块引用可以嵌套（例如：引用内的引用），只要根据层次加上不同数量的 >：

> This is the first level of quoting.

>

> > This is nested blockquote.

>

> Back to the first level.

引用的区块内也可以使用其他语法，包括标题、列表、代码区块等：

> ## 这是一个标题。

> 

> 1. 　这是第一行列表项。

> 2. 　这是第二行列表项。

> 

> 给出一些例子代码：

> 

> return shell_exec("echo $input | $markdown_script");

5.粗体与斜体

两个 * 或_包含一段文本就是粗体的语法，用一个 * 或_包含一段文本就是斜体的语法。

 *一盏灯*， 一片昏黄；**一简书**， 一杯淡茶。 守着那一份淡定， 品读属于自己的寂寞。 保持淡定， 才能欣赏到最美丽的风景！ 保持淡定， 人生从此不再寂寞。

6.代码引用

　　需要引用代码时，如果引用的语句只有一段，不分行，可以用－－将语句包起来，这个符号是键盘左上角的那个。

'代码'

　　如果引用的语句为多行，可以将－－置于这段代码的首行和末行显示行号。

```

代码

```

　　代码内插入”　`　“反引号，则需要加两个``反引号：

``There is a literal backtick (`) here.``

　　或者在``后面加一个空格：

A single backtick in a code span: `` ` ``

A backtick-delimited string in a code span: `` `foo` ``

　　另外，要在 Markdown 中建立代码区块很简单，只要简单地缩进 4 个空格或是 1 个制表符就可以，但是不显示行号，例如，下面的输入：

这是一个普通段落：

  这是一个代码区块。

7.表格

示例１：

| Tables        | Are           | Cool  |

| ------------- |:-------------:| -----:|

| col 3 is      | right-aligned | $1600 |

| col 2 is      | centered      | $12   |

| zebra stripes | are neat      | $1    |

显示效果：

TablesAreCoolcol 3 isright-aligned$1600col 2 iscentered$12zebra stripesare neat$1

示例２：

dog | bird | cat----|------|----foo | foo  | foobar | bar  | barbaz | baz  | baz

显示效果;

dogbirdcatfoofoofoobarbarbarbazbazbaz

8.缩进

使用一个'*'号，后面空格表示缩进位数：

* 　Lorem ipsum dolor sit amet, consectetuer adipiscing elit.

  　Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,

  　viverra nec, fringilla in, laoreet vitae, risus.

* 　Donec sit amet nisl. Aliquam semper ipsum sit amet velit.

  　Suspendisse id sem consectetuer libero luctus adipiscing.

等同于：

* 　Lorem ipsum dolor sit amet, consectetuer adipiscing elit.

Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,

viverra nec, fringilla in, laoreet vitae, risus.

* 　Donec sit amet nisl. Aliquam semper ipsum sit amet velit.

Suspendisse id sem consectetuer libero luctus adipiscing.

9.分割线

　　你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线，行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线：

* * *

***

*****

- - -

---------------------------------------

10.反斜杠

　　Markdown 支持以下这些符号前面加上反斜杠来转义特殊字符：

\ 反斜线

` 反引号

* 星号

_ 底线

{} 花括号

[] 方括号

() 括弧

# 井字号

+ 加号

- 减号

. 英文句点

! 惊叹号

11.兼容HTML

　　在 Markdown 文件里加上一段 HTML 表格， <div>、<table>、<pre>、<p> 等标签，必须在前后加上空行与其它内容区隔开，还要求它们的开始标签与结尾标签不能用制表符或空格来缩进：

这是一个普通段落。

<table>

    <tr>

        <td>Foo</td>

    </tr>

</table>

这是另一个普通段落

　　具体HTML语法，这里不再说明，需要的可参考：Markdown　语法说明(简体中文版)，以及文档HTML语法

参考：Markdown　语法说明(简体中文版)、Markdown 新手指南