Markdown是一种具有纯文本格式语法的轻量级标记语言。常用于GitHub的说明和博客的编写,就比如我显现所写的。本篇介绍我所了解到的Github风格的Markdown语法。
(上代码下效果)
参考博客
说明
由于MarkDown语法较多,常用的语法也是用的非常熟练了,因此本文只对一些不常用的容易混淆的语法进行筛选。
通用特性
链接
Markdown支持两种形式的链接语法:行内 和 参考 两种形式,两种都是使用方括号把文字转成链接。
- 行内形式 直接在后面的括号中放入链接:
行内形式链接
[行内形式链接](https://github.com/)
同时可以加上title属性:
行内形式链接 带Title
[行内形式链接 带Title](https://github.com/ 'GitHub')
- 参考形式 的链接可以为链接定义一个名称,之后可以在文件的其他地方使用它。同时定义的名称支持字母、数字和空格,但是不分大小写。
参考形式链接-数字命名
参考形式链接-字母命名
[参考形式链接-数字命名][1]
[参考形式链接-字母命名][a]
// 注意一定要有换行
[1]: #参考博客
[a]: https://github.com/
- 另外Markdown链接支持 网页锚点,当括号内的链接不以
http://
、https://
、ftp://
等标准开头的话将默认作为相对路径进行访问。
作为锚点时只针对标题有效,标识如下。
#标题
当出现多个相同命名的标题时可以根据标题的顺序在标题后加上-x
进行标识
x
为当前标题在所有相同标题中出现顺序,不用考虑标题层级
#标题
#标题-2
#标题-3
#标题-4
#标题-5
图片
图片的语法和链接很像,也分为 行内形式 和 参考形式。
- 行内形式(title 是选择性的):
![](/content/images/2020/03/1.gif)
- 参考形式:
![][img]
// 注意一定要有换行
[img]: /content/images/2020/03/2.gif
自动链接
Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱,只要是用方括号包起来,Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样,例如:
https://github.com
<https://github.com>
邮址的自动链接也很类似,只是 Markdown 会先做一个编码转换的过程,把文字字符转成 16 进位码的 HTML实体,这样的格式可以糊弄一些不好的邮址收集机器人,例如:
address@example.com
<address@example.com>
反斜杠
Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号。
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号:
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号
HTML特殊字符自动转换表
特殊字符 | 表示方法 |
---|---|
< | < |
& | & |
© | © |
GitHub特有的特性
复选框列表
在列表符号后面加上[]
或者[x]
代表选中或者未选中情况
- [x] 鸡蛋
- [] 牛肉
- [x] 牛奶
- [x] 香蕉
- [x] 鸡胸肉
- [] 全麦面包