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特殊字符自动转换表

特殊字符 表示方法
< &lt;
& &amp;
© &copy;

GitHub特有的特性

复选框列表

在列表符号后面加上[]或者[x]代表选中或者未选中情况

- [x] 鸡蛋
- [] 牛肉
- [x] 牛奶
- [x] 香蕉
- [x] 鸡胸肉
- [] 全麦面包