十分钟快速上手 markdown

news2025/2/2 23:48:20

前言

本人利用寒假期间，将自己所学的markdown的知识，以及将自己常用的一些操作和注意事项记录下来，希望能够帮助大家

一、markdown是什么

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

二、如何使用markdown

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

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

三、基本语法

3.1 标题

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

# 标题一
## 标题二
### 标题三
#### 标题四
##### 标题五
###### 标题六

效果如下：

标题一

标题二

标题三

标题四

标题五

标题六

3.2 字体

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

*这是一个斜体*  
_这也是斜体_  
**这是粗体**  
__这也是粗体__  
***这是一个粗斜体***  
___这也是粗斜体___

效果如下：

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

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

3.3 换行

下面是常用的换行方式

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

3.4 引用

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

> 这是一个引用
>> 引用的引用
>>> 引用的引用的引用

效果如下：

这是一个引用

引用的引用

引用的引用的引用

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

3.5 链接

方式如下：

[链接名称](链接地址)或<链接地址>
即：
[百度](https:www.baidu.com)
或者
<https:www.baidu.com>

效果如下：

百度
或者
https:www.baidu.com

3.6 图片

方式如下：

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

效果如下：

一个AI生成的动漫人物

3.7 列表

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

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

* 无序列表 1
* 无序列表 2
* 无序列表 3

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

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

1. 有序列表 第一层
    1.1 有序列表 第二层

效果如下：

无序列表 1
无序列表 2
无序列表 3

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

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

有序列表第一层
1.1 有序列表第二层

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

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

代码如下：

分割线：

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

~~删除线~~

<u>下划线</u>

效果如下：

分割线：

~~删除线~~

下划线

3.9 代码块

只需要用反引号`引起来

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

代码：

`Hello` World.

在这里插入图片描述

效果如下：

Hello World.

#include<iostream>
int main(){
   printf("HelloWorld");
}

3.10 表格

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

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

代码：

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

效果如下：

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

3.11 特殊符号

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

代码如下：

\\  
\*  
\_  
\+  
\.  
等等

效果如下：

\
*
_
+
.
等等

3.12 脚注

代码如下：

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

效果如下：

使用 Markdown¹可以效率的书写文档, 直接转换成 HTML², 你可以使用 Typora³ 编辑器进行书写。