参考:Markdown中文说明, Markdown syntax, Markdown syntax (Github)
Markdown是一种轻量级的「标记语言」,不能实现HTML语法上的全部功能,但可以和HTML混合使用,并且更加灵活、智能。
在行首插入 1 到 6 个 #
,对应到 1 到 6 级标题:
# Header 1
## Header 2
### Header 3
#### Header 4
##### Header 5
###### Header 6
如果只需要两级标题,可以使用=
和 -
:
这是1级标题
==========
这是2级标题
---------------------------
[TOP]
在文字前加上+
, -
或*
可形成无序列表。
+ 一
+ 二
+ 三
显示为:
行首为“数字-句点-空白”时会自动形成有序列表。
2008. Beijing.
2012. London.
显示为:
Beijing.
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,如:
## 链接 {#link}
引用方式为:
对比“[链接](#link)”格式。
显示为:
对比“链接”格式。
[TOP]
使用反斜线可以在正文中插入一些Markdown语法占用的符号,如:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
[TOP]
Markdown是一种轻量级的「标记语言」。 ↩