markdown基本语法

2012-12-22 Markdown 阅读量

标题设置

在Markdown当中设置标题，有两种方式：

第一种：通过在文字下方添加“=”和“-”，他们分别表示一级标题和二级标题。称为类 Setext 语法：

//一级标题
h1 - h6
===========

//二级标题
h1 - h6
-----------

第二种：在文字开头加上 “#”，通过“#”数量表示几级标题。（一共只有1~6级标题，1级标题字体最大）,称为类 atx 语法：

# 这是 H1

## 这是 H2

###### 这是 H6

块注释（blockquote）

Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。（当>和文字之间添加五个blank时，块注释的文字会有变化。）

斜体

将需要设置为斜体的文字两端使用1个“*”或者“_”夹起来

粗体

将需要设置为斜体的文字两端使用2个“*”或者“_”夹起来

无序列表

在文字开头添加(*, +, and -)实现无序列表。但是要注意在(*, +, and -)和文字之间需要添加空格。（建议：一个文档中只是用一种无序列表的表示方式）

有序列表

使用数字后面跟上句号。（还要有空格）

链接（Links）

Markdown中有两种方式，实现链接，分别为内联方式和引用方式。

内联方式：

This is an [example link](http://example.com/).

引用方式：

I get 10 times more traffic from [Google][1] than from [Yahoo][2] or [MSN][3].  
[1]: http://google.com/        "Google" 
[2]: http://search.yahoo.com/  "Yahoo Search" 
[3]: http://search.msn.com/    "MSN Search"

图片（Images）

图片的处理方式和链接的处理方式，非常的类似。

内联方式：

![alt text](/path/to/img.jpg "Title")

引用方式：

![alt text][id] 
[id]: /path/to/img.jpg "Title"

代码（HTML中所谓的Code）

实现方式有两种：

第一种：简单文字出现一个代码框。使用 <blockquote> 。（[`]不是单引号而是左上角的ESC下面~中的）
第二种：大片文字需要实现代码框。使用Tab和四个空格。

脚注（footnote）

实现方式如下：

hello[^hello]
[^hello]: hi

下划线

在空白行下方添加三条“-”横线。（前面讲过在文字下方添加“-”，实现的2级标题）

参考自：

markdown语法说明：http://www.appinn.com/markdown/
Markdown官方网站：http://daringfireball.net/projects/markdown/
推荐一款在线的Markdown编辑器：https://stackedit.io/