markdown使用笔记

Posted on | Visitors:

Markdown是一种具有纯文本格式语法的轻量级标记语言。常用于GitHub的说明和博客的编写，就比如我显现所写的。本篇介绍我所了解到的Github风格的Markdown语法。
（上代码下效果）

参考博客

说明

由于MarkDown语法较多，常用的语法也是用的非常熟练了，因此本文只对一些不常用的容易混淆的语法进行筛选。

通用特性

链接

Markdown支持两种形式的链接语法：行内 和 参考 两种形式，两种都是使用方括号把文字转成链接。

1
[行内形式链接](https://github.com/)

同时可以加上title属性：
行内形式链接 带Title

1
[行内形式链接 带Title](https://github.com/ 'GitHub')
1
2
3
4
5
[参考形式链接-数字命名][1]
[参考形式链接-字母命名][a]
// 注意一定要有换行
[1]: #参考博客
[a]: https://github.com/
  • 另外Markdown链接支持 网页锚点，当括号内的链接不以http://、https://、ftp:// 等标准开头的话将默认作为相对路径进行访问。
    作为锚点时只针对标题有效，标识如下。
1
#标题

当出现多个相同命名的标题时可以根据标题的顺序在标题后加上-x进行标识
x为当前标题在所有相同标题中出现顺序，不用考虑标题层级

1
2
3
4
5
#标题
#标题-2
#标题-3
#标题-4
#标题-5

图片

图片的语法和链接很像，也分为 行内形式 和 参考形式。

  • 行内形式（title 是选择性的）：
1
![](/img/AcFun/1.gif)
  • 参考形式：
1
2
3
![][img]
// 注意一定要有换行
[img]: /img/AcFun/2.gif "AcFun"

自动链接

Markdown 支持以比较简短的自动链接形式来处理网址和电子邮件信箱，只要是用方括号包起来，Markdown 就会自动把它转成链接。一般网址的链接文字就和链接地址一样，例如：
https://github.com

1
<https://github.com>

邮址的自动链接也很类似，只是 Markdown 会先做一个编码转换的过程，把文字字符转成 16 进位码的 HTML实体，这样的格式可以糊弄一些不好的邮址收集机器人，例如：
address@example.com

1
<address@example.com>

反斜杠

Markdown 可以利用反斜杠来插入一些在语法中有其它意义的符号。
Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号：

1
2
3
4
5
6
7
8
9
10
11
12
\   反斜线
`   反引号
*   星号
_   底线
{}  花括号
[]  方括号
()  括弧
#   井字号
+   加号
-   减号
.   英文句点
!   惊叹号

HTML特殊字符自动转换表

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

GitHub特有的特性

复选框列表

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

1
2
3
4
5
6
- [x] 鸡蛋
- [] 牛肉
- [x] 牛奶
- [x] 香蕉
- [x] 鸡胸肉
- [] 全麦面包

emoji表情

😊👇👇👇👇👇👇
Emoji表情表点我点我👈
☝️☝️☝️☝️☝️☝️☝️