Markdown 简明语法

参考:Markdown中文说明, Markdown syntax, Markdown syntax (Github)



Markdown是一种轻量级的「标记语言」,不能实现HTML语法上的全部功能,但可以和HTML混合使用,并且更加灵活、智能。

在行首插入 1 到 6 个 # ,对应到 1 到 6 级标题:

如果只需要两级标题,可以使用=-

这是1级标题
==========

这是2级标题
---------------------------

[TOP]


列表

在文字前加上+ -*可形成无序列表。

+ 一
+ 二
+ 三

显示为:

行首为“数字-句点-空白”时会自动形成有序列表。

2008. Beijing.    

2012. London.

显示为:

  1. Beijing.

  2. London.

大家可能已经发现这个例子是有问题的,我们的原意并不是为了形成列表,这种情况下应记作:

2008\. Beijing.    

2012\. London.

显示为:

2008. Beijing.

2012. London.

[TOP]


换行和段落

行尾两个空格是换行(<br>),空行则生成段落(<p>)。

[TOP]


粗体和斜体

这是**粗体**,这是*斜体*,***也可以这样***。

显示为:

这是粗体,这是斜体也可以这样

[TOP]


分割线

三个以上*-,就是分割线。注意行内不能有空格以外的其它元素。

[TOP]


引用

在文本前加入 > 这种尖括号(大于号)就是引用的格式。这种引用格式可以嵌套,可以包含其它Markdown元素。

> 这是引用的**区块**。

显示为:

这是引用的区块

[TOP]


代码

行内的代码,用反引号扩起来即可,`hello world`是代码,显示为hello world

行首插入1个Tab或者4个空格,就形成了代码区块。

<p> 这是一个代码区块。 </p>

[TOP]


表格

|名次|国家/地区|金|银|铜|总|
|:---:|:---:|---:|---:|---:|---:|
|1|美国|930|729|637|2296|
|2|苏联|395|319|296|1010|
|3|英国|207|255|252|714|

显示为:

名次 国家/地区
1 美国 930 729 637 2296
2 苏联 395 319 296 1010
3 英国 207 255 252 714


[TOP]


更详细的说明请看[这里](http://about.uuspider.com/2015/06/29/markdown.html)。

显示为:

更详细的说明请看这里

如果链接比较多而且长,也可以这样写:

参考文档包括:[简体中文版][no.1],[繁体中文版][no.2],以及[英文版][no.3]。

[no.1]: http://about.uuspider.com/2015/06/29/markdown.html '简体中文说明'
[no.2]: https://github.com/othree/markdown-syntax-zhtw/blob/master/syntax.md "繁体中文说明"
[no.3]: http://daringfireball.net/projects/markdown/syntax (英文说明)

显示为:

参考文档包括:简体中文版繁体中文版,以及英文版

如果需要加入target="_blank"属性,可以这样写:

在新窗口打开这个[网页][new]{:target="_blank"}。

[no.1]: http://about.uuspider.com/2015/06/29/markdown.html '简体中文说明'

显示为:

在新窗口打开这个网页

更简单的链接形式是这样的:

<http://bing.com/>
<address@example.com>

显示为:

http://bing.com/
address@example.com

[TOP]


图片

插入图片的语法和链接的语法相似,只要在"["前加一个"!"

![Alt text](http://example.com/img.png "Title")

也可以写成这样:

![Alt text][img1]

[img1]: http://example.com/img.png "Title"

[TOP]


脚注的标记方式和链接相似,区别在于"^"

已经有越来越多的网站都支持Markdown[^1]了。

[^1]:Markdown是一种轻量级的「标记语言」。

显示为(脚注内容会被排到文末):

已经有越来越多的网站都支持Markdown1了。

[TOP]


标题id

标题支持id属性,本文的标题都设置了id,如:

## 链接 {#link}

引用方式为:

对比“[链接](#link)”格式。

显示为:

对比“链接”格式。

[TOP]


转义符

使用反斜线可以在正文中插入一些Markdown语法占用的符号,如:

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

[TOP]


  1. Markdown是一种轻量级的「标记语言」。