一、markdown是什么

Markdown 是一种轻量级标记语言,说白了就是可以让你利用最简单的语法达到最好的排版效果

二、如何使用markdown

首先基本上大部分的IDE内都自带markdown的功能,例如:pycharm、VScode等,使用的时候直接创建 .md 文件,在文件内进行即可。

注意:每个IDE使用markdown部分语法存在差异,个人建议还是使用专业的markdown编辑工具( Typora、Bear 等)

三、基本语法

3.1 标题

使用 # 标记,最后一个#字符与标题中间留一个空格。

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

效果如下:

标题一

标题二

标题三

标题四

标题五
标题六

3.2 字体

使用 * 和 \ 对字体进行设置

1
2
3
4
5
6
*这是一个斜体*  
_这也是斜体_
**这是粗体**
__这也是粗体__
***这是一个粗斜体***
___这也是粗斜体___

效果如下:

这是一个斜体
这也是斜体
这是粗体
这也是粗体
这是一个粗斜体
这也是粗斜体

快捷键:
加粗Ctrl+B
斜体Ctrl+I

3.3 换行

下面是常用的换行方式

直接在一句话后敲两个空格
两句话之间加一个空行
如果想让一行文字在显示的时候换行,就在中间加< br / >

3.4 引用

使用 > 来实现,还可以进行嵌套使用,具体使用看代码

1
2
3
> 这是一个引用
>> 引用的引用
>>> 引用的引用的引用

如下:

这是一个引用

引用的引用

引用的引用的引用

注意:在引用的区块内,允许换行存在,换行并不会终止引用的区块。如果要结束引用,需要一行空白行,来结束引用的区块。

3.5 链接

方式如下:

1
2
3
4
5
[链接名称](链接地址)或<链接地址>
即:
[百度](https:www.baidu.com)
或者
<https:www.baidu.com>

效果如下:

链接名称或<链接地址>
即:
百度
或者
https:www.baidu.com

3.6 图片

方式如下:

1
2
3
![图片描述,可写可不写,但是中括号要有](图片地址,本地链接或者URL地址。)
示例如下:
![一个AI生成的动漫人物]("https://i-blog.csdnimg.cn/direct/7f92ae8988714197a4856a8e869ef4c9.jpeg")

效果如下:
图片描述,可写可不写,但是中括号要有
示例如下:
一个动漫人物

3.7 列表

列表分为有序列表和无序列表

无序列表,使用 *、+、- ,再加一个空格作为列表的标记
有序列表,使用数字并加上.号,再加一个空格作为列表的标记
如果想要控制列表的层级,则需要在列表符号前使用 Tab

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
* 无序列表 1
* 无序列表 2
* 无序列表 3

1. 有序列表 1
2. 有序列表 2
3. 有序列表 3

* 无序列表 第一层
* 无序列表 第二层
* 无序列表 第三层
* 无序列表 第四层

1. 有序列表 第一层
1.1 有序列表 第二层
  • 无序列表 1
  • 无序列表 2
  • 无序列表 3
  1. 有序列表 1
  2. 有序列表 2
  3. 有序列表 3
  • 无序列表 第一层
    • 无序列表 第二层
      • 无序列表 第三层
        • 无序列表 第四层
  1. 有序列表 第一层
    1.1 有序列表 第二层
    1.1 有序列表 第二层

3.8 分割线、删除线、下划线

分割线:一行中用三个-or*来建立一个分割线,但是注意:在分割线的上面空一行,否则会导致前一行字体放大。
删除线:添加删除线的文字前后添加两个~
下划线:下划线的使用和html中类似,在需要添加下划线的文字首尾添加文本
代码如下:

分割线:

1
2
3
4
5
6
7
8
---
***
- - -
* * *

~~删除线~~

<u>下划线</u>

效果如下:

分割线:

1
2
3
4
5
6
7
8
---
***
- - -
* * *

~~删除线~~

<u>下划线</u>

3.9 代码块

只需要用反引号`引起来

如果是需要引用代码的话,则在需要引用的代码块的前一行和后一行使用三个反引号,同时在前一个反引号后写入代码的语言。

代码:

1
2
```
`Hello` World.
1
2

效果如下:

Hello World.

1
2
3
4
5
```
#include<iostream>
int main(){
printf("HelloWorld");
}

3.10 表格

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

:—- : 将表头及单元格内容左对齐
—-: : 将表头及单元格内容右对齐
:—: : 将表头及单元格内容居中
代码:

1
2
3
4
5
| 项目       |     价格 | 数量 | 其他 |
|:---------|-------:|:--:|----|
| C语言速成 | \$2000 | 66 | 无 |
| python速成 | \$1200 | 78 | 无 |
| java速成 | \$1000 | 42 | 无 |

效果如下:

项目 价格 数量 其他
C语言速成 $2000 66
python速成 $1200 78
java速成 $1000 42

3.11 特殊符号

前面加反斜线 \ 即可以显示符号本身。

代码如下:

1
2
3
4
5
\\  
\*
\_
\+
\.

等等
1
2
3
4
5
6
效果如下:

\
*
_
+
.
等等

63.12 脚注

代码如下:

使用 Markdown[^1]可以效率的书写文档, 直接转换成 HTML[^2], 你可以使用 Typora[^T] 编辑器进行书写。

1
2
3
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.

效果如下:
[^1]:Markdown是一种纯文本标记语言
[^2]:HyperText Markup Language 超文本标记语言
[^T]:NEW WAY TO READ & WRITE MARKDOWN.
使用 Markdown1可以效率的书写文档, 直接转换成 HTML2, 你可以使用 Typora3 编辑器进行书写。

注意:脚注自动被搬运到最后面,请到文章末尾查看,并且脚注后方的链接可以直接跳转回到加注的地方

转载至(https://blog.csdn.net/2302_78492008/article/details/145414902)