MarkDown基本语法

前言

总目录
MarkDown是一种轻量级的语言，由于易写易读的特性，越来越被程序员们所喜爱，下面我就介绍一下MarkDown的用法吧。

---

1.MarkDown概述

1.基本信息

Markdown 是一种轻量级标记语言，为约翰·格鲁伯（John Gruber）在2004年创造。 这个语言的目的是希望大家使用“易于阅读、易于撰写的纯文字格式，并选择性的转换成有效的XHTML（或是HTML）”，MarkDown文件的后缀名为 .md，.markdown。

2.优点

（1）轻量，简洁
（2）易写易读，提高编写文档效率
（3）MarkDown编写的文档可导出多种格式，如PDF,HTML,图片等等

3、常用MarkDown编辑器

Typora,VSCode，Obsidian，MarkdownPad，Haroopad…等等，编辑器种类繁多，用的顺手即可。

二、MarkDown基本语法

1.标题

使用#号标记，一级标题对应一个 # 号，二级标题对应两个 # 号，以此类推，一共有六级标题。

# 一级标题
## 二级标题.......
依次类推

注意：# 和标题之间需要有一个空格

2.文本样式

（1）斜体加粗

斜体文字，可用一对*或_将文字包裹住。
加粗文字，用两对*或_将文字包裹住。
斜体加粗，用三对*或_将文字包裹住。

*斜体文字*
**加粗文字**
***斜体加粗***

效果如下：斜体文字，加粗文字，斜体加粗

（2）删除线

使用~~将需要删除线的文字包裹住，如

~~删除文本~~

效果如：删除文本

（3）下划线

使用HTML中的标签u，如

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

效果如：下划线文本

（4）引用文本

使用> 后面 加一个空格 然后写文本，如

> 引用文本

效果如：

引用文本

双层引用：一层引用加一个>

> 第一层引用
>> 第二层引用 
>>> 第三层引用

效果如下：

第一层引用

第二层引用

第三层引用

（5）注脚

一个具有注脚的文本。[^注脚]
[^注脚]:这里写解释性文字 

效果如：一个具有注脚的文本。¹

注脚是一对的，第一行表示标注，第二行表示标注的解释

（5）分隔符

使用三个“-” 则可以形成分隔符
如我们使用---时，效果如下：

---

3.列表

（1）列表用 - 后面一个空格 就是列表（当然使用 + 或* 替换_都是可以的）

- 列表项1
- 列表项2

效果如下：

• 列表项1
• 列表项2

（2）列表项内套用列表项，只需在子列表前按下Tab/或者打4个空格，然后使用 - 加一个空格

- 列表项1
	- 子列表项1
	- 子列表项2 
- 列表项2

效果如下：

• 列表项1
  • 子列表项1
  • 子列表项2
• 列表项2

（3）列表项，标注完成状态

- [] 计划任务，注意[ ]中需要有一个空格，文字和中括号之间也需要有个空格
- [x] 完成任务

效果如下：

• 计划任务，注意[ ]中需要有一个空格，文字和中括号之间也需要有个空格
• 完成任务

4.超链接

使用[]+()的方式表示超链接，用法如下：

[总目录](https://blog.csdn.net/qq_39847278/article/details/127617179)

中括号内放需要链接的内容，小括号内放链接地址，效果如：总目录，鼠标点击即可跳转。

5.图片

格式：![alt 属性文本](图片地址)
 ![Alt](https://img-home.csdnimg.cn/images/20220524100510.png)

6.表格

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

|  表头   | 表头  |
|  ----  | ----  |
| 单元格  | 单元格 |
| 单元格  | 单元格 |

设置表格的对齐方式：

-: 设置内容和标题栏居右对齐。
:- 设置内容和标题栏居左对齐。
:-: 设置内容和标题栏居中对齐。
效果如下：

左对齐	右对齐	居中对齐
单元格	单元格	单元格
单元格	单元格	单元格

7.代码片

如果是段落上的一个函数或片段的代码可以用反引号把它包起来（` ），例如：
printf() 函数

可以用 ```包裹一段代码，并指定一种语言（也可以不指定）

```csharp
Console.Write(“”);
Console.ReadLine();
```
效果如下：

Console.Write("");
Console.ReadLine();

8.目录

使用[TOC]即可生成目录

二、进阶用法

1.支持的 HTML 元素,常用<kbd> 和</br>

不在 Markdown 涵盖范围之内的标签，都可以直接在文档里面用 HTML 撰写。
目前支持的 HTML 元素有：<kbd> <b> <i> <em> <sup> <sub> <br>等 ，如：

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

效果如下：
使用 Ctrl+Alt+Del 重启电脑

---

如：

<b>你好</b><br/><sub>女士们<sub/>，<sup> 乡亲们</sup> ~

效果如下：
你好
_{女士们， ^乡亲们 ~}

2.转义

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

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

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

\ 反斜线
` 反引号
* 星号
_ 下划线
{} 花括号
[] 方括号
() 小括号
# 井字号
+加号
- 减号
. 英文句点
! 感叹号

3.各类公式与流程图

日常使用不多，对于这种可以直接通过图片解决，如果需要自己研究，详情可查：
LaTex数学公式
甘特图
UML图
Flowchart流程图

案例：
Gamma公式展示 $\Gamma (n)=(n-1)!\forall n\in \mathbb{N}$ 是通过 Euler integral

$$\Gamma (z)={\int }_0^{\infty }{t}^{z-1}{e}^{-t}dt.$$

总结

总目录
以上就是今天要讲的内容，本文介绍MarkDown的基本语法，希望以上内容可以帮助到大家，如果不对之处，还请批评指正。

---

参考文档：https://www.runoob.com/markdown/md-tutorial.html

---

1. 这里写解释性文字 ↩︎