Markdown基本语法

Tue, Jun 11, 2019

Markdown基本语法

Markdown基础语法(官方教程)：https://www.markdownguide.org/basic-syntax/

一、标题

支持六级标题

示例：

# 这是一级标题
## 这是二级标题
### 这是三级标题
#### 这是四级标题
##### 这是五级标题
###### 这是六级标题

效果如下：

这是一级标题

这是二级标题

这是三级标题

这是四级标题

这是五级标题

这是六级标题

二、字体

斜体

使用一个星号：”*“，星号与文字之间不要有空格

加粗

使用两个星号：”**”

斜体加粗

使用三个星号：”***”

删除线

使用两个阔折号：”~~”

**`示例：`**
```
**这是加粗的文字**
*这是倾斜的文字*
***这是斜体加粗的文字***
~~这是加删除线的文字~~
```

**`效果如下：`**  
**这是加粗的文字**  
*这是倾斜的文字*  
***这是斜体加粗的文字***  
~~这是加删除线的文字~~

换行

末尾输入两个空格
使用HTML的<br>标签
换两行。注意，这种应该叫新段落，因为行间距比普通的换行大

首行缩进

使用特殊占位符
注意：不同的占位符所占空白大小不一样

1) &nbsp; 或 &#160;     // 比半角小
2) &ensp; 或 &#8194;    // 半角
3) &emsp; 或 &#8195;    // 全角

效果如下：
1
1
1

全角下输入两个空格
这个会导致首段不能缩进

三、引用

在需要引用的文字前面加入大于号即可：”>“。
引用也可以嵌套，可以使用多个大于号：”>>>”

示例：

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

效果如下：
>这是引用的内容 >>这是引用的内容 >>>>>>>>>>这是引用的内容

四、分割线

使用三个及以上的减号"-"或星号"*"，效果是一样的

示例：

---
----
***
****

`效果如下：`

五、图片

语法：

![avatar](url "title")

1. avatar：当图片找不到时，显示的内容。也可用于搜索引擎对图片查找。(可以不填，但中括号不能缺)
2. url：图片地址，支持本地目录和网络地址。也支持SVG格式的矢量图片。
3. title：鼠标悬浮在图片时，提示的文字(可不填，则不显示)

示例：

![百度首页](https://www.baidu.com/img/bd_logo1.png "百度")

效果如下：

Markdown图标

其他：
还可以使用图片的Base64字符串来插入图片
参考这篇博客：MarkDown添加图片的三种方式

六、超链接

语法：

[name](url "title")

1. name：链接显示的名称
2. url：链接的地址
3. title：鼠标悬浮时的提示。不填时，默认值为url的值。

示例：

[Markdown官网](https://www.markdownguide.org/)

效果如下：
Markdown官网

其他：
也可以先将url统一写在文章最下面，然后使用序号引用，具体请百度

七、列表

无序列表

使用减号"-"、加号"+"、星号"*"任何一种即可，注意于内容直接要有空格

示例：
```
- 列表内容
+ 列表内容
* 列表内容
```
效果如下：
- 列表内容
- 列表内容
- 列表内容
有序列表

数字 + 点"."

示例：
```
1. 列表内容
2. 列表内容
3. 列表内容
```
效果如下：
1. 列表内容
2. 列表内容
3. 列表内容
列表嵌套

在下一级的前面加两个空格即可

示例：
```
- 一级无序列表内容
  - 二级无序列表内容
  - 二级无序列表内容
  - 二级无序列表内容
```
效果如下：
- 一级无序列表内容
  - 二级无序列表内容
  - 二级无序列表内容
  - 二级无序列表内容
其他：
由于Markdown对缩进的支持不太好，实际的一级列表应该为实心圆点，以上用了缩进对齐所以就不是实际的一级列表

八、表格

语法：

表头|表头|表头
---|:--:|---:
内容|内容|内容
内容|内容|内容

1. 表头与内容的减号"-"分割线，有一个就行了
2. 文字默认左对齐，使用冒号":"来调整。两边冒号为居中，右侧为右对齐
3. 原生的语法，两边都要用竖线"|"，包起来，这边省略了

示例：

姓名|技能|排行
--|:--:|--:
刘备|哭|大哥
关羽|打|二哥
张飞|骂|三弟

效果如下：
姓名|技能|排行 –|:–:|–: 刘备|哭|大哥关羽|打|二哥张飞|骂|三弟

九、代码

语法：

单行代码：使用一个反引号"`"包起来。两个也可以。当然不一定要用来写代码

代码块：使用三个反引号"```"包起来，且每组反引号单独占一行。第一组反引号后可以接上代码类型(Java, PHP, Markdown)。

示例：

    `单行代码`


    ```Java
    public static void main(String[] args) {

    }
    ```

效果如下：
单行代码

public static void main(String[] args) {

}

十、流程图

语法：

```flow
st=>start: 开始
op=>operation: My Operation
cond=>condition: Yes or No?
e=>end
st->op->cond
cond(yes)->e
cond(no)->op
&```

其他：
VS Code不支持流程图