markdown 语法学习

markdown是一种轻量级的标记语言，和html类似，但是易读性比html要好很多。

基本语法:

1.标题和正文分隔线

=== //至少三个连续等号，最高阶标题

--- //或者三个连续的减号，第二高阶标题

2.标题字体大小

用若干个 # 为前缀 //#的个数对应于html中的 hx，即 1个# 为h1的大小， 6个# 为h6 的大小

3.生成段落

使用一个或多个空行来分隔内容段，用来生成段落。只使用换行符，但行与行中间没有空行，则这些行的内容在markdown中会被连到一块，但中间会有空格。

4.引用

使用 > 作为段落标记，来表示该段内容为引用，而且引用的内容会在显示的时候显示引用痕迹。

在引用之内可以使用其他标签，也可以使用更深一层的引用。

5.列表

有序列表，使用

1. xxx

2. xxx

等用数字加 . 的形式来表示有序列表（. 之后有一个空格）

无序列表，使用 *, +, - 前缀表示无序列表（*/+/- 之后有一个空格）

6. 换行

如果只是在段落内部换行，可以使用<br> 换行符. 或者可以用两个或两个以上空格加回车来实现换行。

7.支持引用式的链接格式，例如mkd代码：

首先，什么是 markdown？我们可以直接看一下 [WIKI][1]……
另外，markdown 可以被编译为 html，比如使用在线的 [Pandoc][2]

[1]: http://en.wikipedia.org/wiki/Markdown "wiki_markdown"
[2]: http://johnmacfarlane.net/pandoc/try "pandoc online"

则在最后的效果中显示为超链接，但是又不出现具体的 http 连接显示。这样在正文中不会出现链接地址这种读者不关心的信息，同时也可以作为变量继续在其他地方引用。

8.支持快捷链接

使用 <链接地址> 的形式，如 <www.taobao.com> ，可以避免html的 <a href="http://ued.taobao.org">http://ued.taobao.org</a>的繁琐。

9.强调

*或_ 包围起来，显示为斜体； ** 或 __ 包围起来显示为粗体

10.代码块 (反单引号)

行内一句代码，使用 `codexx` ; 代码段落，使用

```

code block xxxx

```

或者使用两个tab来作为代码块的开始（在代码块的每一行都有两个tab）

11.表格

|item | value | quality|

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

|it1 | 1.0 | 5 |

|it2 | 2.0 |10|

在mkd代码中，竖杠不需要对齐，只需要在第二行的 :--- 表示左对齐， ---:表示右对齐， :---: 表示中间对齐

12.分隔线

在一行中可以使用三个以上的 *, -, _ 来作为两行的分隔线。

13. 图片

行内式：

![description](/path/xxx.img)

![description](/path/xxx.img "optional title")

一个惊叹号 !
接着一个方括号，里面放上图片的替代文字
接着一个普通括号，里面放上图片的网址，最后还可以用引号包住并加上选择性的 'title' 文字。

参考式：

![description][id]

[id]是图片参考的名称，图片参考的定义方式则和连结参考一样：

[id]: url/to/image "optional attribute"

14. 自动链接

markdown支持以简短的自动链接的形式来处理网络和电子邮箱，只要使用尖括号包起来，markdown就会将他们自动转化为链接。（测试发现，对于链接性质的文本，即使使用尖括号括起来，也会被markdown自动转换为链接?）

<xxxx@163.com>

15.反斜杠转义

markdown可以使用\来插入一些特殊字符，如* - _等。markdown支持的转义字符：

\   反斜线
`   反引号
*   星号
_   底线
{} 花括号
[] 方括号
() 括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

示例mkd代码：

##this is a title##

===

hello ,what are you doing ?

>Action speak louder than words

>>this is a tst

>>>this is a tst

###this is a level-3 header

1. this is a ordered list 1

2. this is a ordered list 2

3. this is a ordered list 3

#####this is a level-4 header

- this is a unordered list4<br>

and this is a newline

- this is a unordered list5<br> this is also a new line

* this is a unordered list6<br> this isa new line too

**this is a strong effect**

__this is also a strong effect__

*this is a italic effect*

_this is also a italic effect

this is a newline _

this is a `#include<iostream>`

```

//this is a code block

#include<iostream>

using namespace std;

int main(){

cout << "hello world" << endl;

return 0;

}

```

首先，什么是 markdown？我们可以直接看一下 [WIKI][1]……

另外，markdown 可以被编译为 html，比如使用在线的 [Pandoc][2]

<http://www.taobao.com>

[Google](http://www.google.com)

|item | value | quality|

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

| it1 | 1.0 | 5 |

|it2 | 2.0 |10|

[1]: http://en.wikipedia.org/wiki/Markdown "wiki_markdown"

[2]: http://johnmacfarlane.net/pandoc/try "pandoc online"

显示效果

this is a title

hello ,what are you doing ?

Action speak louder than words

this is a tst

this is a tst

this is a level-3 header

this is a ordered list 1
this is a ordered list 2
this is a ordered list 3

this is a level-4 header

this is a unordered list4
and this is a newline
this is a unordered list5
this is also a new line
this is a unordered list6
this isa new line too

this is a strong effect

this is also a strong effect

this is a italic effect

_this is also a italic effect
this is a newline _

this is a #include<iostream>

//this is a code block

#include<iostream>

using namespace std;

int main(){

   cout << "hello world" << endl;

   return 0;

}

首先，什么是 markdown？我们可以直接看一下 WIKI…… 另外，markdown 可以被编译为 html，比如使用在线的 Pandoc

http://www.taobao.com
Google

aaarticlea/png;base64,iVBORw0KGgoAAAANSUhEUgAAAMEAAABGCAIAAAD6lWerAAAECklEQVR4nO2dwZmkIBBGJzjD2DupEAqJeNkwSMQ92CpFAUKXQLnzv5t2j1Xga0CEb342AGT8zE4AvB44BKTAISDlFzrknVkOjPOz06lFb9pih1a7F8uuT6QziiNrXTfjlkTaCuq/g0MKSnXPJ8mXOZRIW0H9d+jL4FA/atJ+l0NHtlfG4Zm47yaffQoYnDPOX13+/kfxcUg4PPhc7zpFj1LXIDcjHmpkhx6pInBoZLt6Zxa7VkZpSLuu/v+Q6xnn44oSM6gv+5yz63aVIKkROz6+nfjpnVURRFptKkg2yeuq8VCDxS0UIV8f8VXvojSnXVX/pYp6ALFDvDrzZYis2Q/L1Vhumtlnq00182cdMmX47z9zd4tF4AnF5t05k+ycatKuqv9kXs914yMcYs3zEhZI4lD0x96Z8FvXPbA2vlWNDpWLwCMGUjc71JR2pUNRZlFFCRnqUIUGjQ6Rj72zrGtKt3XfO1SuerFDzWnXOkQu9mQjtA3uy4ot9pcOXX9vTDaHbJLNfdlN5Qv7sva06x0KR5rPPrI9NqbO3438t8j4tO6nmaAiHg9/NxTlY5FCEfLJ5EbmmSiCtMv1Tz55ekJD5hB9lDxzix9uEyc/X6YX2B+DS8eFNHJDk2VZFuuuI+P+8mkBVppzLBIWLFkEBnlmN+x+lqO0pd1S/2fwx+eNfuH7sqEom8sMh4yPAYe6UjkWH5GDcb6LQXCoI2w+YJZHZ4/XqTWEQ0AKHAJS4BCQAoeAFDgEpMAhIAUOASlwCEiBQ0DKTIe8M3reJIGvgUNAipq+bLXw6aWod8g7M8at20DkHeoY3dlWH5W/smkOhevv4qoi6xu7v/CuCrSnSNfndn8Pn1ooqRA146FMO+SdGbNoohho14xttundKqxWZ8MTMbUvC71R7dBqWbOTOPU4D+4j7AkcqgjEm6EhDZF35liPrXYstG1wqC7QpHZo27wnOzp0agSHagJNGg9Rxlj7BaocStTQsHvFAlFvpjyXUdROyU5zKJxtiZ/lU3vPOtZeOhBreybMDxHgEGgkbpjVKgSH1EIHiKlHQy3AIcXQjdMq/dk2OATkwCEgBQ4BKXAISIFDQAocAlLgEJAy912HymlX0AgcAlJ09GXY1PFm1Do07C15daChGbHrz141UGCOQ3ebOuiCsI5riKoDDVk/lN1homD1UgEd46G4HYpuZj+JKgMNXcfIVlSqWEVZYF5fVrEQ9mDY+DsXaOh6aubQtNXclbzBoekKjd3XETs0aVdJPeodmi7QtqEdKqPZIRX6XF/AeCiDHofoz2rYjFE20LR9HQlB8FzGudnUkfmvhc/XWinQjH0dha0smB8C/zFwCEiBQ0AKHAJS4BCQAoeAFDgEpMAhIOUfT2J4L8xKB54AAAAASUVORK5CYII=" alt="" />