VScode:实用 Markdown 插件推荐

👇 连享会 · 推文导航 | www.lianxh.cn

连享会：2026AI-Agent专题 · 线上时间：6月20-21日嘉宾：李学恒 (中山大学)咨询：王老师 18903405450（微信）

作者： 连玉君 (中山大学)邮箱： arlionn@163.com

温馨提示： 文中链接在微信中无法生效。请点击底部「阅读原文」。或直接长按/扫描如下二维码，直达原文：

1. 为何要装插件？
2. 常用插件介绍

2.1 Markdown 基本功能增强
2.2 代码块支持
2.3 格式美化和幻灯片制作
2.4 特殊需求支持

3. 插件配置：定制你的插件

3.1 如何打开配置文件
3.2 如何配置参数

4. 其他备选插件
5. 结语
6. 参考资料
7. 附录：生成本文的提问脚本

说明：
本文 90% 以上的内容是由 ChatGPT 4o 生成的。成稿后，我对局部文字进行了修改和润色，以便符合中文表述习惯。
与 ChatGPT 4o 的对话过程：-点击查看- (需要通过 VPN 查看)
本文 7. 附录：生成本文的提问脚本 小节记录了我向 ChatGPT 4o 的推文脚本。

Title: VScode：实用 Markdown 插件推荐
Keywords: Markdown All in One, Markdown Preview Enhanced, Code Runner, Stata Enhanced, Markdown Table Formatter, Marp for VS Code, Assist, Markdown Lint, Markdown Formatter, Excel to Markdown table, Markdown Preview Mermaid Support, Jupyter, Python, Markdown文档转换

这篇推文将为大家介绍在 VScode 中使用 Markdown 写作和笔记时的实用插件。通过这些插件的帮助，你可以更高效地编写、预览和格式化 Markdown 文档，同时支持多种编程语言的代码块和数学公式。我们还将介绍如何配置这些插件，让你能够定制符合自己需求的工作环境。

1. 为何要装插件？

Markdown 是一种轻量级标记语言，非常适合用来写作和笔记。VScode 作为一款强大的编辑器，不仅支持多种编程语言的开发，还能通过安装插件大大增强其功能，使其成为写作 Markdown 文档的理想工具。

插件的作用在于提供更强大的功能和更便捷的操作。例如，使用插件可以让你轻松预览 Markdown 文件、在文档中插入数学公式和代码块、将文档导出为不同格式，甚至可以自动美化文档格式。这些功能可以大幅提高工作效率和文档质量。

2. 常用插件介绍

根据插件的功能，我们将推荐的插件分为以下几类：

Markdown 基本功能增强
代码块支持
格式美化和幻灯片制作
特殊需求支持

2.1 Markdown 基本功能增强

Markdown All in One
更多关于 Markdown 图片处理的技巧，可以参考初虹的推文：Markdown图片神器：PicGo-让你爱上笔记与分享。

数学公式渲染
自动更新目录
侧边预览
功能：提供多种 Markdown 支持，包括自动完成、键绑定、片段和预览功能。
安装：在 VScode 中按 Ctrl+P，然后输入 ext install yzhang.markdown-all-in-one。
核心功能：

Markdown Preview Enhanced
如果你对 Markdown 的更多高级使用感兴趣，可以参考连享会的推文：Markdown常用LaTex数学公式。

支持 LaTeX 数学公式
支持多种输出格式：HTML, PDF, Word
自定义渲染样式
功能：提供强大的 Markdown 预览功能，支持数学公式渲染、代码块高亮和图表生成。
安装：在 VScode 中按 Ctrl+P，然后输入 ext install shd101wyy.markdown-preview-enhanced。
核心功能：

2.2 代码块支持

Code Runner

支持多语言代码运行
自动保存文件
在终端中运行代码
功能：支持运行多种编程语言的代码，包括 Stata, R 和 Python。
安装：在 VScode 中按 Ctrl+P，然后输入 ext install formulahendry.code-runner。
核心功能：

Stata Enhanced
关于在 VScode 中使用 Stata 进行更多操作的详细指南，可以参考陈楚的推文：Stata+Markdown：输出幻灯片+PDF+Word-markstat。

Stata 语法高亮
代码片段和自动补全
功能：提供 Stata 语法高亮和代码片段，使得在 VScode 中编写 Stata 代码更加方便。
安装：在 VScode 中按 Ctrl+P，然后输入 ext install kylebarron.stata-enhanced。
核心功能：

2.3 格式美化和幻灯片制作

Markdown Table Formatter

自动对齐表格列
多种表格格式支持
功能：自动格式化 Markdown 表格，使表格对齐整齐，美观易读。
安装：在 VScode 中按 Ctrl+P，然后输入 ext install TakumiI.markdowntable。
核心功能：

Marp for VS Code
如果你想快速掌握 Marp 制作幻灯片的方法，可以参考宋森安的推文：用Markdown制作幻灯片-五分钟学会Marp（上篇）和用Markdown制作幻灯片-五分钟学会Marp（下篇）。

支持 Markdown 语法编写幻灯片
实时预览
支持导出为 PDF、PPTX
功能：使用 Markdown 创建幻灯片，并在 VScode 中预览和导出为 PDF。
安装：在 VScode 中按 Ctrl+P，然后输入 ext install marp-team.marp-vscode。
核心功能：

2.4 特殊需求支持

Assist

自动在中英文混排时添加空格
自定义添加空格规则
格式化 Markdown 文档
功能：在中英文混排时自动添加空格，保持文本格式的美观。
安装：在 VScode 中按 Ctrl+P，然后输入 ext install BlackINTL.assist。
核心功能：

Markdown Lint

实时语法检查
提供格式化建议和自动修复功能
支持自定义规则
功能：提供 Markdown 文件的语法检查和格式化建议，帮助保持文档的一致性和可读性。
安装：在 VScode 中按 Ctrl+P，然后输入 ext install DavidAnson.vscode-markdownlint。
核心功能：

3. 插件配置：定制你的插件

每个插件在初次安装后都会有一些默认配置，以便满足大多数用户的需求和习惯。如果你需要进行个性化配置，可以根据自己的情况修改 VScode 编辑器的全局配置或某个插件的局部配置。常规配置主要包括：编辑器外观、窗口布局、字体颜色和字号等；个性化配置则主要涉及插件具体功能的启用和关闭。

更多关于 Markdown 在 VScode 中的配置和使用，可以参考这篇推文：初虹，Markdown-LaTeX：经管人的VSCode配置大全。

3.1 如何打开配置文件

打开用户设置（全局配置）

在 VScode 中按下 Ctrl+, 或通过菜单栏选择 File -> Preferences -> Settings。
在设置界面右上角点击齿轮图标，选择 Open Settings (JSON)。

打开工作区设置（针对于某个项目配置）

在 VScode 中打开你要配置的工作区。
按下 Ctrl+Shift+P，输入 Preferences: Open Workspace Settings (JSON) 并回车。

3.2 如何配置参数

配置文件中可以添加以下配置来定制插件的行为。

Markdown Preview Enhanced 配置示例

{"markdown-preview-enhanced.previewTheme": "github-light.css","markdown-preview-enhanced.codeBlockTheme": "default.css","markdown-preview-enhanced.previewLanguages": ["stata","r","python"  ],"markdown-preview-enhanced.printOnSave": true}

Markdown All in One 配置示例

{"markdown.extension.math.enabled": true,"markdown.extension.toc.updateOnSave": true,"markdown.extension.preview.autoShowPreviewToSide": true}

Code Runner 配置示例

{"code-runner.executorMap": {"stata": "stata-se -b do","r": "Rscript","python": "python"  },"code-runner.saveFileBeforeRun": true,"code-runner.runInTerminal": true}

Assist 配置示例

{"assist.enabled": true,"assist.languages": ["markdown", "plaintext"]}

4. 其他备选插件

Markdown Formatter

功能：格式化 Markdown 文档，使其更加整齐美观。
主页：Markdown Formatter

Excel to Markdown table

功能：将 Excel 表格转换为 Markdown 表格，方便在文档中使用。
主页：Excel to Markdown table

Markdown Preview Mermaid Support

功能：支持在 Markdown 预览中渲染 Mermaid 图表，适合绘制流程图、序列图等。
主页：Markdown Preview Mermaid Support

Jupyter

功能：支持 Jupyter Notebook，可以在 VScode 中编辑和运行 Jupyter Notebook。
主页：Jupyter

Python

功能：提供丰富的 Python 开发支持，包括代码补全、调试、测试等功能。
主页：Python

5. 结语

总结这些插件及其功能，可以帮助你在 VScode 中更高效地进行 Markdown 文档的编写、预览和格式美化。

下面是一个插件功能的总结表：

插件名称	功能描述
Markdown All in One	自动完成、键绑定、片段、预览
Markdown Preview Enhanced	数学公式渲染、代码块高亮、导出多种格式
Code Runner	运行多种编程语言的代码
Stata Enhanced	Stata 语法高亮、代码片段
Markdown Table Formatter	自动格式化 Markdown 表格
Marp for VS Code	使用 Markdown 创建幻灯片
Assist	中英文混排自动添加空格，格式化文档
Markdown Lint	实时语法检查、格式化建议
Markdown Formatter	格式化 Markdown 文档
Excel to Markdown table	将 Excel 表格转换为 Markdown 表格
Markdown Preview Mermaid Support	渲染 Mermaid 图表
Jupyter	支持 Jupyter Notebook
Python	提供丰富的 Python 开发支持

需要提醒大家的是，插件并不是越多越好，因为功能相似的插件有时候会存在冲突。因此，在完成特定任务时，为避免插件冲突，可以「临时禁用」不必要的插件，仅保留必须的插件。

我们可以通过以下步骤「临时禁用」、「重新启用」或「删除」插件：

临时禁用插件：在插件面板中找到插件，点击插件右侧的齿轮图标，选择 “禁用” (Disable)。
重新启用插件：在插件面板中找到已禁用的插件，点击插件右侧的齿轮图标，选择 “启用” (Enable)。
删除插件：在插件面板中找到插件，点击插件右侧的齿轮图标，选择 “卸载” (Uninstall)。

6. 参考资料

Markdown-LaTeX：经管人的VSCode配置大全
Markdown图片神器：PicGo-让你爱上笔记与分享
Markdown常用LaTex数学公式
Stata+Markdown：输出幻灯片+PDF+Word-markstat
用Markdown制作幻灯片-五分钟学会Marp（上篇）
用Markdown制作幻灯片-五分钟学会Marp（下篇）

7. 附录：生成本文的提问脚本

说明：

该附录记录了我在生成本文过程中向 ChatGPT 提出的问题。原始对话过程中一共提问 9 次，这里展示了其中的 7 个，我删去的两个问的不准确或表述不完整的问题。
本附录的 Diag7： 是用于生成本附录的提问脚本。
后文 Note：xxxx 部分的文字是我自己添加的。

Diag1： VScode 中的 Markdown 插件问题。我平时在 VScode 中用 Markdown 写笔记和推文。我的常规需求如下：推文中会包含一些描述计量模型的数学公式；推文中会包含 Stata, R, Python 的代码块和回归结果展示；有时我看到一些不错的网页，想直接把网页中的内容复制到 VScode 编辑器中，希望编辑器自动帮我把 HTML 格式的网页内容转换成 Markdown 格式的代码。我希望我写的 Markdown 文本可以被渲染成简洁大方的 HTML, PDF 和 Word 文档。比如，github, vim 风格。且这些文档可以很方便地输出和存储。我的问题：请帮我推荐几个合适的 VScode 插件。

Diag2： 能否把「插件配置」部分写的更详细一些？
如何进行插件配置。输入哪些命令可以打开你展示的 JSON 页面？是全局配置还是进针对于某个插件进行配置？
能否对一些关键配置语句的作用和其它备选填项进行简要说明？

Diag3： 再帮我补充几个插件的介绍，表述和写作风格与前面的相似。
Stata 相关的插件：语法高亮；在 VScode 中运行 Stata
幻灯片插件：marp
中英文混排添加空格的插件：如 assist，或者对 Markdown 文档进行格式化调整和美化的插件。
其它你认为比较重要的插件

Diag4： 请把上述内容整合为一篇中文推文。
标题：VScode：实用 Markdown 插件推荐结构
为何要装插件？Markdown 简介；简要介绍 VScode 编辑器；插件的重要作用；Note: 上述介绍过程中可按如下格式插入 https://www.lianxh.cn 相关推文：黄欣怡, 2020, Stata 倍分法DID: 不满足平行趋势假设咋办？, 连享会 No.129.
常用插件介绍可以根据插件作用进行分类，把上面提到的插件分成 2-4 类，先进行概述;逐个介绍上述插件的作用、安装方法和一些核心功能的使用方法
插件配置：定制你的插件(1) 如何打开配置文件(2) 如何配置参数(3) 实例演示只需选择 4-5 个前面提到的插件介绍其配置方法即可，无需全部介绍。
结语最好列个表格，对前面介绍的插件总结。

Diag5： 请修改：

「结语」部分，请在表格中列出文中提及的所有插件，不要遗漏
请给推文中的标题加上序号，采用 1. xxx; 1.1 xxx; 1.2 xxx 这种样式
文中提及的源自 https://www.lianxh.cn 的推文采用推文标题格式即可，形式如下：- [Markdown-LaTeX：经管人的VSCode配置大全](https://www.lianxh.cn/details/1004.html)- [Markdown图片神器：PicGo-让你爱上笔记与分享](https://www.lianxh.cn/details/769.html)- [Markdown笔记利器：Typora主题-最美的模板](https://www.lianxh.cn/details/1018.html)

完整的推文引用信息放在最后一个小节「## 参考资料」部分。

Note: 至此，正文部分已经全部生成

Diag6： 帮我补充如下内容：在 **Keywords**: 部分补充推文中的关键词，如文中提及的所有插件的名称；Markdown文档转换等。关键词之间用半角逗号分开。
要求：只需输出如下两行即可，正文不必重复输出- **Title**: VScode：实用 Markdown 插件推荐- **Keywords**: ？？？

Note: 整理生成的内容是推文的头部信息，我未做任何进一步改动。

Diag7： 把我提出的所有问题的原文贴出来，不要做任何修改和合并。我提出的每个问题记录一段，不要切割。格式如下：**Diag1：** xxx
**Diag2：** xxx 以此类推

Note: 该对话用于生成本文的附录，我对输出结果做了约 10% 篇幅的修改。

New！ Stata 搜索神器：lianxh 和 songblGIF 动图介绍
搜：推文、数据分享、期刊论文、重现代码 ……
👉 安装：
. ssc install lianxh
. ssc install songbl
👉 使用：
. lianxh DID 倍分法
. songbl all

🍏 关于我们

连享会 ( www.lianxh.cn，推文列表) 由中山大学连玉君老师团队创办，定期分享实证分析经验。
直通车： 👉【百度一下：连享会】即可直达连享会主页。亦可进一步添加「知乎」,「b 站」,「面板数据」,「公开课」等关键词细化搜索。