概述
Markdown 语法的目标是:成为一种适用于网络的书写语言。
Markdown 不是想要取代 HTML,甚至也没有要和它相近,它的语法种类很少,只对应 HTML 标记的一小部分。Markdown 的构想不是要使得 HTML 文档更容易书写。在我看来, HTML 已经很容易写了。Markdown 的理念是,能让文档更容易读、写和随意改。HTML 是一种发布的格式,Markdown 是一种书写的格式。就这样,Markdown 的格式语法只涵盖纯文本可以涵盖的范围。
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。不需要额外标注这是 HTML 或是 Markdown;只要直接加标签就可以了。
要制约的只有一些 HTML 区块元素――比如 <div>
、<table>
、<pre>
、<p>
等标签,必须在前后加上空行与其它内容区隔开,还要求它们的开始标签与结尾标签不能用制表符或空格来缩进。Markdown 的生成器有足够智能,不会在 HTML 区块标签外加上不必要的 <p>
标签
区块元素
标题
在行首插入 1 到 6 个 # ,对应到标题 1 到 6 阶
# 这是H1
## 这是H2
### 这是H3
#### 这是H4
###### 这是H5
####### 这是H6
区块引用
Markdown 标记区块引用是使用类似 email 中用 > 的引用方式。
Markdown 文件中建立一个区块引用,那会看起来像是你自己先断好行,然后在每行的最前面加上 >:
> 这是一段引用1
> 这是一段引用2
> 这是一段引用3
这是一段引用1
这是一段引用2
这是一段引用3
Markdown 也允许你偷懒只在整个段落的第一行最前面加上 > :
> 这是一段引用1
这是一段引用2
这是一段引用3
区块引用可以嵌套(例如:引用内的引用),只要根据层次加上不同数量的 >
引用的区块内也可以使用其他的 Markdown 语法,包括标题、列表、代码区块等
列表
Markdown 支持有序列表和无序列表。
无序列表
无序列表使用星号、加号或是减号作为列表标记:
* 无序列表1
* 无序列表2
* 无序列表3
等同于
+ 无序列表4
+ 无序列表5
+ 无序列表6
也等同于
- 无序列表7
- 无序列表8
- 无序列表9
- 无序列表1
- 无序列表2
- 无序列表3
- 无序列表4
- 无序列表5
- 无序列表6
- 无序列表7
- 无序列表8
- 无序列表9
有序列表
有序列表则使用数字接着一个英文句点:
1. 有序列表1
2. 有序列表2
3. 有序列表3
- 有序列表1
- 有序列表2
- 有序列表3
代码区块
要在 Markdown 中建立代码区块很简单,只要简单地缩进 4 个空格或是 1 个制表符就可以,例如,下面的输入:
这是一个普通段落
这是一个代码区块。
这是一个普通段落
这是一个代码区块。
分隔线
你可以在一行中用三个以上的星号、减号、底线来建立一个分隔线,行内不能有其他东西。你也可以在星号或是减号中间插入空格。下面每种写法都可以建立分隔线:
* * *
***
*****
- - -
----------------------------
区段元素
链接
要建立一个行内式的链接,只要在方块括号后面紧接着圆括号并插入网址链接即可,如果你还想要加上链接的 title 文字,只要在网址后面,用双引号把 title 文字包起来即可,例如:
这个是一个[百度](http://www.baidu.com "百度")链接
这个是一个百度链接
强调
<em>
使用星号(*)和底线(_)作为标记强调字词的符号,被 * 或 _ 包围的字词会被转成用 标签包围
*强调*
_强调_
强调
<strong>
用两个 * 或 _ 包起来的话,则会被转成 ,例如:
**强调**
__强调__
强调
代码
如果要标记一小段行内代码,你可以用反引号把它包起来(`),例如:
打印HelloWorld的代码为`console.log("Hello World")`
打印HelloWorld的代码为console.log("Hello World")
图片
-
一个惊叹号 !
-
接着一个方括号,里面放上图片的替代文字
-
接着一个普通括号,里面放上图片的网址,最后还可以用引号包住并加上 选择性的 ‘title’ 文字。
[外链图片转存失败(img-W39k6eiE-1565055651276)(/blog/img/avatar.png “头像”)]
[外链图片转存失败(img-xfFug2f1-1565055651276)(/blog/img/avatar.png “头像”)]
其他
反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号
\*Hello World\*
*Hello World*
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来, Markdown 就会自动把它转成链接。
一般网址的链接文字就和链接地址一样,例如:
<http://www.baidu.com>
邮址的自动链接:
<905375993@qq.com>