# VSCode+Markdown学习

一、VSCode介绍

Visual Studio Code（简称”VS Code“）是Microsoft在2015年4月30日Build开发者大会上正式宣布一个运行于 Mac OS X、Windows和 Linux 之上的，针对于编写现代Web和云应用的跨平台源代码编辑器， 可在桌面上运行，并且可用于Windows，macOS和Linux。它具有对JavaScript，TypeScript和Node.js的内置支持，并具有丰富的其他语言（例如C/C++，C＃，Java，Python，PHP，Go）和运行时（例如.NET和Unity）扩展的生态系统。

VSCode有很多原来编辑器很多不具备的优化，所以一经推出就迅速获得人们的青睐和好评。优点如下：

1. 免费，开源
2. 跨平台
3. 可远程操作
4. 支持自由插件任意扩展
5. 安装轻量快捷
6. 运行稳定，bug少
7. 大平台支持更新有保证

二、Markdown介绍

Markdown 是一种轻量级标记语言，创始人为约翰·格鲁伯（John Gruber）。一个可以运行与Windows、linux和Mac OS等操作系统之上，它允许人们使用Markdown语言编写易读易写的纯文本格式文档，然后转换成有效的 XHTML（或者HTML）文档。这种语言吸收了很多在电子邮件中已有的纯文本标记的特性。它的后缀是.md,拥有如下优点：

1. 轻量化，易读易写，
2. 支持图片、表格、数学公司等特殊符号
3. 许多网站都广泛支持Markdown语言来撰写文档
4. Markdown文档可以快速转化为PPT、Word和PDF等文档格式
5. 可以用于编写代码说明文档，以“RADME.md”文件名保存在软件目录下即可

三、VSCode支持Markdown功能

VSCode默认已经支持Markdown语言，但是这里需要说明一下，因为Markdown只是一个语言格式，并没有强制标准，所以不同的Markdown工具，不同的网址，VSCode不同的插件Markdown的语法并不完全相同。

为了更好的在VSCode使用Markdown，我们根据参考链接安装三种插件：

1. Markdown All in One --提供丰富的Markdown语言相关快捷键和自动补全功能，提高md文档编写能力
2. Markdown Preview Ehanced --用于同步预览当前编写Markdown文档
3. Past Image --用于快速引用图片到Markdown文档
4. 安装完毕后重启VSCode，然后uncheck调用如下属性，至此VSCode+Markdown学习环境搭建完成

取消勾选操作完成图

四、VSCode环境下Markdown基本语法学习

（1）创建.md文件和预览功能

创建Markdown格式文件就是文件名+.md后缀，注意使用Preview功能对md文件预览。

预览功能按钮

（2）标题

#+空格+标题名 表示标题，一共有6级标题，==每个md文档第一级标题是独有的，其他几种标题可以共存==

（3）文本显示

• 普通文本

因为Markdown不支持行缩进，所以普通文本直接写即可。

• 加粗文本

实现规则：两个+文本+两个，快捷键：ctrl+b，示例：这是一段加粗文本，可使用鼠标选中文本，然后ctrl+b反复切换

• 斜体文本

实现规则：一个+文本+一个，快捷键：ctr+i，示例：这是一段加粗文本，可使用鼠标选中文本，然后ctrl+i反复切换

• 高亮文本

实现规则：两个=+文本+两个=，快捷键：无，示例：==这是一段高亮文本==

• 删除线文本

实现规则：两个~+文本+两个~，快捷键：无，示例：这是一段删除线文字

• 下划线文本

实现规则：<大写U>+文本+</大写U>，实现下划线文本功能，快捷键：无，示例：<U>这是一段加粗的文字</U>

• 分割线

实现规则：三个*+回车，实现分割线功能，快捷键：无，示例如下：

***

（4）段落

段落，应该是从英文翻译而来，看作者概括成大换和小换，感觉概括成大换行和小换行应该更贴切。如下两个示例，从实际显示效果更容易看出差异，小换行从实际来看没有真的换行。大换行实现了真的换行。

小换行上半部，

小换行下半部，

大换行上半部，

大换行下半部，

（5）有序列表和无序列表

有序号列表，简称有序列表

输入规则：数字+.+空格+文本，退出输入再次回车即可，示例如下：

1. 第一段有序号列表
2. 第二段有序号列表
3. 第三段有序号列表
4. 第四段有序号列表

无序号列表，简称无序列表

输入规则：*+.+空格+文本，退出输入再次回车即可，示例如下：

• 第一段有序号列表
• 第二段有序号列表
• 第三段有序号列表
• 第四段有序号列表

（6）上下标和勾选框

上下标

上标是啥？看下面的例子一目了然，多用于数学公式表示。输入规则：^符号加到上标文本左右

上标示例

实际例子：X^2^ X^Y^

下标是啥？看例子一目了然，多用于化学公式表示。输入规则：~符号加到下标文本左右

下标示例

实际例子：Fe~3~O~4~

勾选框

勾选框是啥？比较好理解就是MFC的checkbox，输入规则：*+空格++空格+空格，退出输入再次回车即可。其中[]中间的空格改为x,则实际显示勾选框已经被选中。

• 是否忽略小数
• MFC checkout框
• Markdown 是否学习过

（7）行内代码和代码块

代码块

代码块，程序员都熟悉，实现规则如下图：

代码块规则

示例如下：

#include <stdio.h>
int main(){
printf("hello world\n");
return 0;
}

行内代码

行内代码，其实就是一行代码。实现规则：前面都有一个`符合即可。与代码块的区别是代码块在一个区域中，而行内代码仅仅一行而已。

示例如下：

#include <stdio.h>

int main(){

printf("hello world\n");

return 0;

}

（8）表格

表格实现规则：符合|分割列，且符号|是实际列数+1；第一行是表格头有且唯一，第二行是左右对齐规则行，:符合代表左对齐，还是右对齐（可选）；-符号所有分隔符（必选）。

分割线示例

（9）图片

实现规则如下图所示，这里要保证png文件与.md文件在同一目录下。

图片规则

示例如下：

图片示例

（10）超链接

复制链接内容，然后再ctrl+v粘贴即可

（11）目录

目录功能实现规则相对简单：下图+回车即可。

目录实现规则

五、参考链接

1. https://blog.csdn.net/hyupeng1006/article/details/129590409
2. https://blog.csdn.net/Q1783698366/article/details/139523849