MarkDown常用语法整理

一、Markdown 标题

1.使用 = 和 - 标记一级和二级标题

例如:

1
2
3
4
5
一级标题
========

二级标题
--------

效果:

一级标题

二级标题

2.使用 # 号标记

使用 # 号可表示 1-6 级标题,一级标题对应一个 # 号,二级标题对应两个 # 号,以此类推。

例如:

1
2
3
4
5
6
# 一级标题
## 二级标题
### 三级标题
#### 四级标题
##### 五级标题
###### 六级标题

效果:

一级标题

二级标题

三级标题

四级标题

五级标题
六级标题

二、Markdown 段落

1.换行

由于编辑器的不同,在换行的处理上有细微差异
1.末尾添加两个空格换行
2.回车空行来换行
3.使用HTML中的<br>标签强制换行

2.字体

例如 :

1
2
3
4
5
6
7
8
9
10
11
12
13
*斜体文本*  

_斜体文本_

**粗体文本**

__粗体文本__

***粗斜体文本***

___粗斜体文本___

~~我是删除线~~

效果:

斜体文本
斜体文本
粗体文本
粗体文本
粗斜体文本
粗斜体文本
我是删除线

下划线

下划线可以通过 HTML 的 <u> 标签来实现:

<u>带下划线文本</u>

效果:

带下划线文本

3.分割线

例如:

1
2
3
4
5
***
* * *
*****
- - -
----------

效果:






4.脚注

脚注是对文本的补充说明。
Markdown 脚注的格式如下:
[^要注明的文本]

1
2
创建脚注格式类似这样 [^RUNOOB]。
[^RUNOOB]: 我是脚注

效果:

创建脚注格式类似这样 ^脚注

5.空格缩进

例如:

1
2
3
4
没有空格
&ensp; 一个空格
&emsp; 两个空格
&nbsp; 一个空格不会触发换行

效果:

没有空格
  一个空格
  两个空格
  一个空格不会触发换行


三、Markdown 列表

1.无序列表

无序列表使用星号(*)、加号(+)或是减号(-)作为列表标记.

例如:

1
2
3
4
5
6
7
8
9
10
11
12
* 第一项
* 第二项
* 第三项

+ 第一项
+ 第二项
+ 第三项


- 第一项
- 第二项
- 第三项

效果:

  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项
  • 第一项
  • 第二项
  • 第三项

2.有序列表

有序列表使用数字并加上 . 号来表示

例如:

1
2
3
1. 文本1
2. 文本2
3. 文本3

效果:

  1. 文本1
  2. 文本2
  3. 文本3

3.列表嵌套

例如:

1
2
3
4
5
6
1. 第一项:
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
2. 第二项:
- 第二项嵌套的第一个元素
- 第二项嵌套的第一个元素

效果:

  1. 第一项:
    • 第一项嵌套的第一个元素
    • 第一项嵌套的第二个元素
  2. 第二项:
    • 第二项嵌套的第一个元素
    • 第二项嵌套的第一个元素

四、Markdown 区块

Markdown 区块引用是在段落开头使用 > 符号 ,然后后面紧跟一个空格符号

1.一级区块

例如:

1
2
3
> 区块引用
> 区块引用
> 区块引用

效果:

区块引用
区块引用
区块引用

2.区块嵌套

另外区块是可以嵌套的,一个 > 符号是最外层,两个 > 符号是第一层嵌套,以此类推:

1
2
3
> 最外层
> > 第一层嵌套
> > > 第二层嵌套

效果:

最外层

第一层嵌套

第二层嵌套


五、Markdown 代码

单行代码使用` …`包裹
多行代码使用```…```包裹

1
2
3
$(document).ready(function () {
alert('RUNOOB');
});

六、Markdown 链接

1.链接使用方法如下:

1
2
3
4
5
6
7
[链接名称](链接地址)

[链接名称](链接地址 "超链接title")

或者

<链接地址>

例如:

1
这是一个链接 [百度](https://www.baidu.com)

效果:

这是一个链接 百度

例如

1
<https://www.baidu.com>

效果:

https://www.baidu.com

2.高级链接

例如:

1
2
3
4
5
6
7
链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 [Google][1]
这个链接用 link 作为网址变量 [百度][link]
然后在文档的结尾为变量赋值(网址)

[1]: http://www.google.com/
[link]: http://www.baidu.com/

效果:

链接也可以用变量来代替,文档末尾附带变量地址:
这个链接用 1 作为网址变量 Google
这个链接用 link 作为网址变量 百度
然后在文档的结尾为变量赋值(网址)


七、Markdown 图片

语法:

1
2
3
4
5
6
![alt 属性文本](图片地址)

![alt 属性文本](图片地址 "可选标题")

图片alt就是显示在图片下面的文字,相当于对图片内容的解释。
图片title是图片的标题,当鼠标移到图片上时显示的内容。title可加可不加

例如:

1
2
3
![哔哩哔哩](https://ss1.baidu.com/6ONXsjip0QIZ8tyhnq/it/u=2810627290,1080409091&fm=58&s=8197C732C535FA313E526557030030BB&bpow=121&bpoh=75 "bilibili")

![blockchain](https://ss0.bdstatic.com/70cFvHSh_Q1YnxGkpoWK1HF6hhy/it/u=702257389,1274025419&fm=27&gp=0.jpg "区块链")

效果:

哔哩哔哩

blockchain

到目前为止, Markdown 还没有办法指定图片的宽高,如果你需要的话,你可以使用普通的 <img> 标签。


八、Markdown 表格

Markdown 制作表格使用 | 来分隔不同的单元格,使用 - 来分隔表头和其他行。

例如:

1
2
3
4
|表头|表头|表头|
|-|:-:|-:|
|内容|内容|内容|
|内容|内容|内容|

效果:

表头 表头 表头
内容 内容 内容
内容 内容 内容

九、Markdown 高级技巧

1.支持的 HTML 元素

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。

目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等 ,如:

例如:

使用<kbd>Ctrl</kbd>+<kbd>C</kbd>复制

效果:

使用Ctrl+C复制

2.转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符,Markdown 使用反斜杠转义特殊字符。

例如:

1
2
**文本加粗** 
\*\* 正常显示星号 \*\*

效果:

文本加粗
** 正常显示星号 **

Markdown 支持以下这些符号前面加上反斜杠来帮助插入普通的符号

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

参考资料

https://www.runoob.com/markdown/md-tutorial.html

-------- 本文结束 感谢阅读 --------
0%