Markdown简单语法

最新推荐文章于 2025-04-22 17:11:06 发布

原创最新推荐文章于 2025-04-22 17:11:06 发布

· 257 阅读

0 ·

版权

文章标签：

#vscode #ide #编辑器

1.Markdown简介

;Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（John Gruber）。它允许人们使用易读易写的纯文本格式编写文档，然后转换成有效的 XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。

2.准备环境

首先准备环境，安装vscode，在vscode编辑器下载插件：

Markdown All In One ——提供丰富的Markdown相关的快捷键、自动补全功能，提高md文档编写生产力
Markdown Preview Enhanced——用于渲染当前编写文档的效果同步预览
vscode-pdf
Paste Image——用于快速引用图片至Markdown文档,截图后，按Ctrl+Alt+V粘贴到指定的位置即可，同时将该截图导入当前工作目录下。（注意如果只是去复制一个图片文件，按Ctrl+Alt+V无效）

3.Markdown基本语法

3.1 标题

# 一级标题
## 二级标题
### 三级标题
…

3.2 段落

Markdown的段落没有特殊的格式，直接编写文字就好，段落的换行号是使用两个以上的空格加回车。

3.2.1 字体

Markdown 可以使用以下几种字体：
用1个星号*或底线_表示斜体
用2个星号*或底线_表示粗体
用3个星号*或底线_表示粗斜体
*字体* 字体
**字体**字体
***字体***字体

3.2.2 分割线

可以在一行中使用三个以上的*、-、_来建立一个分隔符，行内不能有其他字符，在字符间插入空格无影响。
***

* * *

_ _ _ _

3.2.3 删除线

如果要在文字上添加删除线，在文字两端加上两个波浪线即可。
~~删除~~
删除

3.2.4 下划线

下划线可使用html的标签来实现
<u>下划线文本</u>
下划线文本

3.2.5 脚注

脚注是对文本的补充说明。(不会显示）格式如下：
这里有一个脚注[^脚注ID1]。
这里有一个脚注[^脚注ID2]。
[^脚注ID1]: 此处是 **脚注1** 的 *文本内容*。
[^脚注ID2]: 此处是 **脚注2** 的 *文本内容*。
效果如下图:

3.3 列表

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

3.3.1无序列表

无序列表使用星号(*)、加号(+)或者减号(-)作为标记：（注意符号和列表名字隔一个空格）
- 第一项
- 第二项
- 第三项

第一项
第二项
第三项

3.3.2有序列表

有序列表直接在文字有加上1. 2. 3. 来表示，会自动填充后续符号，符号和文字之间加上一个空格字符，如：
1. 第一项
2. 第二项
3. 第三项

第一项
第二项
第三项

3.3.3 列表嵌套

列表嵌套只需在子列表的选项前添加四个空格即可：

第一项：
- 第一项嵌套的第一个元素
- 第一项嵌套的第二个元素
第二项：
- 第二项嵌套的第一个元素
- 第二项嵌套的第二个元素

3.4 区块引用

> 区块引用
> Markdown教程
> 学的不仅是技术更是梦想

区块引用
Markdown教程
学的不仅是技术更是梦想

3.5 代码块

可以用```(Esc键下面这个符号）前后包裹一段代码，并指定一种语言（也可以不指定）：

#include<iostream>
using namespace std;
int main(){
    cout<<1<<endl;
    return 0;
}

如果是段落上的一个函数或片段的代码可以用两个’把它包起来。
print() 函数

3.6 链接地址

链接使用方法如下：
[链接名称](链接地址)或者<链接地址>
例如：
[百度一下](https://www.baidu.com/)
<https://www.baidu.com/>
百度一下
 https://www.baidu.com/

3.7 图片

只需要在基础语法的括号中填入图片的位置路径即可，支持绝对路径和相对路径。
例如：
![图片](D:/xxx/md/1.png)
![图片]：如果图片无法加载，默认显示”图片“文字
(D:/xxx/md/1.png)：图片的路径，尽量写全路径，一定要注意路径的/方向，反了可获取不到。

3.8 表格

Markdown制作表格使用|来分隔不同的单元格，使用-来分隔表头和其他行。
第一行是表头以”|“区分列

第二行是对齐方式， "-“表示默认对其即左对齐，在”-“左侧加”:“为左对齐，在右侧加”:“为右对齐，两边都加”:“为剧中对齐（”-"的个数可随便写，按照自己的喜好对齐即可，冒号一定要是英文字符！！！）
语法格式：

|表头1|表头2|表头2|
|----|:----:|----:|
|单元格11|单元格12|单元格12|
|单元格21|单元格22|单元格12|
显示效果：

表头1	表头2	表头2
单元格11	单元格12	表头13
单元格21	单元格22	表头23

3.9 转义

3.9.1 使用反引号（`）将其包起来

#这是井号
*这是星号
>这是大于号

3.9.2 使用反斜杠\转义

#：这是井号
*：这是星号
>：这是大于号

3.10 数学公式

当你需要在编辑器中插入数学公式时，可以使用两个美元符 $$ 包裹 TeX 或 LaTeX 格式的数学公式来实现。
实例如下：

显示效果： $\int_0^1 {x^2} \,{\rm d}x$

参考文章1
参考文章2