VSCode编写markdown文档--安装使用教程

文章目录

一、下载安装VSCode

官方下载地址

如图所示，根据电脑操作系统选取对应的软件进行安装。

二、下载相关插件

根据需要，选择下载相关插件（我下载了前3个，其余插件仅大致说明功能）。

2.1 插件名称列表

• Markdown Preview EnhancedMarkdown Preview Enhanced是一个非常受欢迎的VSCode扩展，它提供了强大的Markdown预览功能，更多的渲染选项和功能扩展。以下是Markdown Preview Enhanced插件的一些主要特点：

1. 多种渲染样式：Markdown Preview Enhanced支持多种预览渲染样式，包括GitHub样式、VuePress样式、Mermaid图表、TeX数学公式渲染等。
2. 实时预览：可以实时预览Markdown编辑的效果，并且支持同步滚动功能，可以在编辑和预览之间同步滚动。
3. 渲染数学公式：Markdown Preview Enhanced内置了MathJax和KaTeX两个数学公式渲染引擎，可以渲染LaTeX格式的数学公式。
4. 导出文件：可以将预览界面导出为HTML、PDF和PNG格式的文件，方便分享和打印。
5. 流程图和时序图：可以使用Mermaid语法在Markdown中绘制流程图、时序图和甘特图。
6. 可视化表格生成器：提供了一个可视化的表格生成器，可以方便地创建复杂的表格。
7. 自定义CSS样式：可以自定义渲染的CSS样式，以满足个性化需求。
8. 可配置选项：Markdown Preview Enhanced提供了丰富的配置选项，可以根据个人喜好进行调整

• Markdown All in OneMarkdown All in One是一个流行的VSCode扩展，提供了一系列方便的Markdown编辑功能和快捷键。以下是Markdown All in One插件的主要特点：

1. 语法高亮：Markdown All in One提供了丰富的语法高亮，能够突出显示不同元素，使Markdown文件更易读。
2. 快速输入：插件提供了一些快捷键和命令，可以快速输入常用的Markdown语法，节省时间和提高效率。
3. 功能完善：Markdown All in One支持Markdown表格、任务列表、目录等常用功能；还包括自动补全、自动格式化、链接引用补全等功能，大大简化了Markdown的撰写过程。
4. 导航和大纲：插件提供了快速导航Markdown文件的功能，可以通过标题大纲或者右侧的导航栏快速跳转到指定位置。
5. 预览和导出：插件内置了Markdown预览功能，可以通过右键点击Markdown文件选择“Markdown: Open Preview”在预览面板即时预览Markdown文件，还可以将预览导出为HTML、PDF和PNG格式文件。
6. 快速切换视图：不论是编辑器还是预览视图，插件提供了快速切换的命令，方便编辑和预览之间的切换。
7. 可配置选项：插件提供了一系列的可配置选项，可以按照个人喜好定制化编辑器的行为和外观。

• Paste ImagePaste Image是一个VSCode插件，它允许你通过复制图片并粘贴到Markdown文件中来快速插入图片。以下是Paste Image插件的主要特点：

1. 快速插入图片：使用Paste Image插件，你可以直接通过复制图片并粘贴到Markdown文件中来快速插入图片，省去了保存图片、上传到服务器或手动编写图片链接的步骤。
2. 支持多种格式：插件支持从剪贴板粘贴多种图像格式，包括但不限于PNG、JPEG、GIF等常见图片格式。
3. 自动重命名和保存：Paste Image插件会自动为粘贴的图片生成一个唯一的文件名，并将其保存在与Markdown文件相同的目录下。
4. 图片尺寸调整：插件提供了一些可选的参数，例如图片缩放、调整大小等选项，以适应不同的需求。
5. 自定义配置：你可以按照自己的需求来自定义插件的配置，包括保存路径、文件名格式等。
6. 快捷命令：插件还提供了一些快捷命令，例如复制图片地址、打开图片等功能，方便你在编辑过程中

• Code Spell CheckerCode Spell Checker是一个VSCode的拼写检查扩展，可以帮助你在编码过程中及时发现和修复拼写错误。
• Markdown PDFMarkdown PDF是一个VSCode插件，它提供了将Markdown文件转换为PDF格式的功能。

2.2 插件离线安装方法

1. 打开 VSCode 插件市场网址Extensions for the Visual Studio family of product，输入要的插件名称，比如要安装的是Markdown All in One插件。
2. 点击进入插件主页，点击右侧的Download Extension链接，得到下载下来的离线安装包，以.vsix为扩展名结尾。
3. 把下载下来的离线安装包拷贝到 VSCode 的安装目录下的 bin 目录下，比如我的 VSCode 安装在D:\software\VScode\Microsoft VS Code\，因此这里我应该拷贝到D:\software\VScode\Microsoft VS Code\bin这个目录下。
4. 在第 3 步的 bin 目录下打开命令窗口(可直接在目录位置输入cmd并回车)，输入命令，最后面的参数换成下载的插件离线安装包的名字即可： code --install-extension yzhang.markdown-all-in-one-3.6.2.vsix
5. 待看到如下提示即意味着安装成功，就可以打开 VSCode 进行查看了: Extension ‘yzhang.markdown-all-in-one-1.4.0.vsix’ was successfully installed! 插件安装完成后的效果图如下：

三、修改VSCode语言为中文

VSCode安装后的默认界面是只有英文的，如果想用中文界面，那么就需要安装对应的插件，vscode插件可以从扩展中心去搜索并安装。

1. 安装vscode后打开vscode，点击左侧的扩展按钮。
2. 在搜索框中输入chinese，弹出chinese（Simplif…简体中文
3. 点击图标右侧的Install即可（我的已经安装过了，所以显示的是设置的图标）
4. 安装完成后等待右下角的restart按钮重启vscode（如图“更改语言并重启的位置”）。重启之后即可看到中文界面的vscode了。

四、使用VSCode编写markdown文档

点击左上角的"文件"菜单，然后选择"新建文件"，或使用快捷键Ctrl+N（Windows）或Cmd+N（Mac）创建一个新文件，文件名命名为后缀名.md的文件，按下"Enter"键即可完成文件创建，具体如下：