节选自Markdown官方文档
Markdown 是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,然后转换成格式丰富的HTML页面。 —— [ 维基百科 ]
标题层级
Markdown 支持两种标题的语法,类 Setext 和类 atx 形式。
类 Setext 形式是用底线的形式,利用 = (最高阶标题)和 - (第二阶标题),例如:This is an H1
=============
This is an H2
-------------
任何数量的 = 和 - 都可以有效果。
类 Atx 形式则是在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶,例如:# 这是 H1
## 这是 H2
###### 这是 H6
你可以选择性地「闭合」类 atx 样式的标题,这纯粹只是美观用的,若是觉得这样看起来比较舒适,你就可以在行尾加上 #,而行尾的 # 数量也不用和开头一样(行首的井字符数量决定标题的阶数):# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
无序列表
可以使用+,-,*做为列表的项目标记,列表项目标记通常是放在最左边,但是其实也可以缩进,最多 3 个空格,项目标记后面则一定要接着至少一个空格或制表符。
加粗
形如:**test**
, test
斜体
形如:*test*
, test
插入链接
1.
形如:[xxx](http://www.baidu.com)
, xxx
2. 参考式的链接是在链接文字的括号后面再接上另一个方括号,而在第二个方括号里面要填入用以辨识链接的标记,This is [an example][id] reference-style link
,接着,在文件的任意处,你可以把这个标记的链接内容定义出来,[id]: http://example.com/ "Optional Title Here"
This is an example reference-style link.
插入图片
很明显地,要在纯文字应用中设计一个「自然」的语法来插入图片是有一定难度的。
Markdown 使用一种和链接很相似的语法来标记图片,同样也允许两种样式: 行内式和参考式。
行内式的图片语法看起来像是:
![Alt text](/path/to/img.jpg)
![Alt text](/path/to/img.jpg "Optional title")
详细叙述如下:
1.一个惊叹号 !
2.接着一个方括号,里面放上图片的替代文字
3.接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 ‘title’ 文字。
参考式的图片语法则长得像这样:
![Alt text][id]
「id」是图片参考的名称,图片参考的定义方式则和连结参考一样:
[id]: url/to/image "Optional title attribute"
到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的<img>
标签。
eg:
<img src="/blog_pic/HeadPic.jpg" height="200" width="200" />
插入代码
要在 Markdown 中建立代码区块很简单,只要简单地使用三个反引号即可,如下例所示
this is normal part。
```
this is code part。
```
表示为:
this is normal part。
1 this is code part。要想在文字中见插入简短的代码,只需在代码的开始和结束各使用单个反引号即可。
反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
例如:如果你想要用星号加在文字旁边的方式来做出强调效果(但不用 标签),你可以在星号的前面加上反斜杠:\*literal asterisks\*
,表示为*literal asterisks*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
符号 | 意义 |
---|---|
\ | 反斜线 |
` | 反引号 |
* | 星号 |
_ | 底线 |
{} | 花括号 |
[] | 方括号 |
() | 括弧 |
# | 井字号 |
+ | 加号 |
- | 减号 |
. | 英文句点 |
! | 惊叹号 |