区块元素
标题
Markdown支持两种标题的语法类Setext和类Atx形式。
类Setext形式是用底线形式利用=
(最高阶标题)和-
(第二阶标题),例如:
这是H1标题
=
这是H2标题
-
任何数量的=
和-
都会起作用
类Atx形式则是在首行插入1-6个#
对应标题的1-6阶,例如:
#这是H1
##这是H2
######这是H6
在行尾加上结束符号也是可以的,而且结束符号的个数不能决定标题的阶数
区块引用Blockquote
在需要使用Blockquote的行或者段落前加上>
符号,就可以表示Blockquote,例如:
>这是两端话的引用
>在每一行都添加了符号
>这是第二段
>每行都有
或者
>这是第一段引用
只在段首添加一个即可
>这是第二段引用
也是只在段首添加
Blockquote可以嵌套试用,例如:
>第一层
>>第二层
Blockquote也可以使用其他Markdown语法,标题、代码等,例如
> ## 这是一个标题
>
列表
MarkDown支持有序列表和无序列表
无序列表有以下三种表达方式
第一种:使用星号
* red
* blue
* yellow
第二种:使用加号
+ red
+ blue
+ yellow
第三种:使用减号
- red
- blue
- yellow
三种效果是一样的,需要注意符号和文字之间要有一个空格隔开
有序列表使用方式是数字加上一个英文句点,但是在html中显示的时候,数字的顺序无所谓,例如:
1.第一行
2.第二行
3.第三行
和
5.第一行
3.第二行
0.第三行
的显示效果是一样的都是
1.第一行
2.第二行
3.第三行
代码区块
想要在markdown中插入代码,可以直接在开始放一个制表符(或者是4个空格),这样就会显示为代码块,结束标志是没有制表符(或者4个空格)时结束。在代码区块中的字符永远显示的都是你写入的原始样子,不会进行转义等操作。例如:
&<>/>
这些字符等都会被原始的显示出来,在使用代码区块的时候要保证上一行为空白行。
分割线
分割线可以使用三个以上的*
或者-
来建立一个分隔符,也可以在它们中间加上空格,但是行内不能有其他符号,注意在使用分割线时,上一行也要是空白行。否则会与Setext标题类语法冲突
***
* * *
---
文字删除线
~~文字删除线~~
预览效果
文字删除线
添加表格
语法如下
|ABCD|EFGH|IGKL|
|:---|:--:|---:|
|a---|b---|c---|
|d---|e---|f---|
|g---|h---|i---|
第二行是标志文本的对齐方式,:-
表示左对齐:-:
表示居中-:
表示右对齐
预览效果
ABCD | EFGH | IGKL |
---|---|---|
a | b | c |
d | e | f |
g | h | i |
区段元素
链接
MarkDown支持两种形式的链接语法:行内式和参考式两种形式
行内式例如:
这是[百度首页](http://www.baidu.com"百度")链接,有标题。
这是[百度首页](http://www.baidu.com)链接,没有标题。
链接文字使用[方括号]
括起来,将链接写在(圆括号)
里面,如果要有标题,就在圆括号的尾部加入双引号,写入标题内容
参考式例如:
这是[百度首页][1]
[1]: http://www.baidu.com "百度"
链接文字使用[方括号]
括起来,后面引用名也用[]
方括号括起来,然后在其他任意地方定义引用。但在加入标题是应注意标题与链接之间需要有一个以上的空格然后在使用引号引起来。
链接内容定义的形式为:
- 方括号(前面可以选择性地加上至多三个空格来缩进),里面输入链接文字
- 接着一个冒号
- 接着一个以上的空格或制表符
- 接着链接的网址
- 选择性地接着 title 内容,可以用单引号、双引号或是括弧包着
以下三种方式表述结果是一样的
[1]: http://www.baidu.com "百度"
[1]: http://www.baidu.com '百度'
[1]: http://www.baidu.com (百度)
链接辨别标签可以有字母、数字、空白和标点符号,但是并不区分大小写,因此下面两个链接是一样的:
[link text][a]
[link text][A]
隐藏链接标记功能,这样可以省略链接标记,这种情况下等于是链接文字例如:
[baidu][]
然后定义链接内容
[baidu]: http://www.baidu.com
强调
MarkDown使用*
或者-
包围起来起到强调的作用。例如:
*是的*
**好的**
_是的_
__好的__
使用一个*
或者_
包围起来是<em>
,使用两个是<strong>
代码
标记一小段行内代码使用反引号`
包起来例如:
我是一个`代码`
如果要在代码区段插入反引号,则可以使用多个反引号来开始和结束代码区段,例如:
``引用`反引号``
图片
图片的引用与链接的引用类似,有行内式和参考式,只需要在最前面加上已个”!”,例如:
![死神](http://e.hiphotos.baidu.com/image/h%3D200/sign=4b8869d4a9345982da8ae2923cf5310b/d009b3de9c82d15810eaa411840a19d8bc3e4222.jpg "具体图片")
![死神][id]
[id]: http://e.hiphotos.baidu.com/image/h%3D200/sign=4b8869d4a9345982da8ae2923cf5310b/d009b3de9c82d15810eaa411840a19d8bc3e4222.jpg
其他
自动链接
一般网址可已直接使用</>
阔起来表示网址链接,不过要写全部的网址,不能省略http例如:
<http://www.baidu.com/>
反斜杠
反斜杠可已插入MarkDown的语法符号,比如想使用*而不做出强调的作用:
\*haode\*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
本文参考自MardDown语法说明(简体中文版);