Markdown 语法学习笔记

852

在很久之前就在微博看到过有人在说锤子便签好用因为支持的书写格式很多,其中就包括Markdown,但是后来并没有深入了解过Markdown到底是什么,语法是什么。
后来在构建个人博客的时候看到博客的格式便是Markdown,所以自然而然地开始简单学习了一下,于是就有了这篇笔记。

Markdown是什么

简单来说,Markdown是一种可以使用普通文本编辑器编写的标记语言,通过简单的标记语法,它可以使普通文本内容具有一定的格式。而且Markdown兼容HTML语法,例如上标下标。Markdown简单易学,轻量便捷,而且功能强大,在各行各业有着广泛的使用。

Markdown语法

一、标题  直接在标题前加#即可标记,#号的数量代表标题大小,可以从1到6,数量越小标题越大,注意输入完#号后加一个空格才可以再输入标题,否则无法识别。标题结束后可以用任意数量的#结尾(#前需要加空格),也可以不加但是如果不加就要换行,要不然后面内容都会被识别为标题。下面是演示:

# 这是主标题 #
## 这是主标题 ##
### 这是主标题 ###
#### 这是主标题 ####
##### 标题后不加井号不换行只加空格 这是后面的文本

这是主标题

这是主标题

这是主标题

这是主标题

标题后不加井号不换行只加空格 这是后面的文本

二、倾斜 加粗 倾斜加粗 删除线  倾斜文本直接再文本两边加 * ,注意两边都不要加空格。同样加粗是在文本两边加两个* ,倾斜加粗是加三个,删除线在文本两边分别加两个~,文本两边都不要添加空格,左右星号数量相等。

*倾斜*
**加粗**
***倾斜加粗***
~~删除线~~
**左边两个星号,右边一个星号*
*右边星号前加空格 *
*右边星号后不加空格*这是右边的文字
*右边不加星号加空格 这是右边的文字 
* 左边星号后加空格或两边都加空格会变成列表,后面会进行演示,这里不再演示*

倾斜
加粗
倾斜加粗
删除线
*左边两个星号,右边一个星号
*右边星号前加空格 *
右边星号后不加空格这是右边的文字
*右边不加星号加空格 这是右边的文字

三、链接  链接用下面的形式表示,其中文本是超链接的文本。

[这是一个超链接](超链接网址)

示例:

[Aengus的网站](http://aengus.top)

效果:
Aengus的网站

四、图片  图片的添加和超链接的表示类似,直接在最前面加一个!。如下所示,其中图片名称可以自定义。

![图片名称](链接)

示例:

![头像](/assets/img/profile.png)

效果:
头像
五、列表  列表分为有序列表和无序列表。无序列表使用星号、加号或是减号作为列表标记,有序列表则使用数字接着一个英文句点,注意在星号、加号、减号或英文句号后文本前要加空格,Markdown以此来区分倾斜和无序列表。
示例:

无序列表:
* 第一条
* 第二条
* 第三条

+ 第一条
+ 第二条
+ 第三条

- 第一条
- 第二条
- 第三条

有序列表:
1. 第一条
2. 第二条
3. 第三条

效果:
无序列表:

  • 第一条
  • 第二条
  • 第三条
  • 第一条
  • 第二条
  • 第三条
  • 第一条
  • 第二条
  • 第三条

有序列表:

  1. 第一条
  2. 第二条
  3. 第三条

当然有序列表的数字并不强制按顺序写,你甚至可以写成这样:

3. 第一条
2. 第二条
5. 第三条

但是得到的效果顺序仍然为1,2,3。
六、代码块 直接输入英文状态下三个反引号就表示代码块,同样以三个反引号结束代码块,大多数键盘反引号位置在Tab键上面,此外也可以用代码块表示方法来表示一些示例,此文中所有示例都是用代码块实现的。
七、分割线 引用 分割线是直接用三个或三个以上的星号或横杆来表示,效果是一样的。

***
---


引用直接用大于号就可以,也可以嵌套。

>这是引用内容
>>这是引用内容
>>>这是引用内容

效果:

这是引用内容

这是引用内容

这是引用内容

八、其他 由于Markdown支持HTML语法,所以可以直接使用HTML来实现一些功能。

n<sub>2</sub>
n<sup>2</sup>

效果:
n2
n2
此外直接输入空格并不会被识别为空格,换行也一样,所以如果需要换行可以直接输入三个或以上的空格即可。如需显示空格,可以用下面的示例表示:

&nbsp; 注意有分号

下面这种形式会被认为是HTML标签

<text>

可以用下面的方法表示:

&lt;  表示<
&gt;  表示>

其他特殊表示方法可以参考这篇文章:https://www.jianshu.com/p/7bcf4ad609cf

由于时间有限,Markdown还有很多语法没有指出,如有需要可以看一下这个网站:https://www.appinn.com/markdown/以及https://www.jianshu.com/p/191d1e21f7ed