轻松记录您
灵感和创意

VScode 打造 Markdown 编辑器

在之前的博文中我分别介绍了 Markdown 的基础语法和数学公式语法,本文主要介绍使用现在非常流行的 Vscode 代码编辑器进行 Markdown 书写的一些配置。

插件

这里主要推荐三款核心插件,其余的可以按需选择。

Markdown All in One 目前 Vscode 最流行的 Markdown 语法解析器。

Markdown PDF 使用的 Markdown 文件渲染导出插件。

Markdown TOC 一款针对 Github 等平台自动生成文章目录的插件(目前主流的博客平台如 CSDN 已经不需要自己在文中生成目录了)。

安装方式也很简单,在 Vscode 的左侧导航栏最后一个联网搜索 Markdown 关键字,找到对应插件点击安装(下图 install)即可,上述几个插件都是高排名插件,最前面就能找到。

Markdown All in One

就像插件的名字一样,将之前很多其他编辑器需要多插件配合的 Markdown 环境整合为一个,支持多种 Markdown 语法、实时预览、快捷键解析等功能。

安装之后打开以.md或者.Markdown为后缀结尾的 Markdown 文件,就可以右侧窗口实时预览渲染效果,当然,也可以使用Ctrl+B这样的快捷键直接进行一些 Markdown 语法操作,这里就是自动补**content**语法标记。

具体的语法可以参考本文引言中的链接,安装后编辑器界面如下。

Markdown PDF

该插件可以实用地将 MArkdown 文件渲染的显示结果(基于 HTML)导出为 HTML、PDF、PDG、JPEG 等格式的文件,而不需要用户自己处理繁琐的图片路径等问题。

安装后在 Markdown 文件的编辑界面中右击即可显示菜单栏,在其中的如下几项就是该插件提供的,点击即可导出,这表示当前 Markdown 文件目录下生成对应 PDF,文件名相同,其他需要的可以自行对插件进行配置。

对当前教程导出后,某一页结果如下。

Markdown TOC

在一些平台如 Github 渲染 Markdown 文件是不能自动目录的,需要自己手写,而繁琐的 HTML 语法又不太方便,使用该插件即可快速生成自动目录。

使用方法很简单,在需要添加目录的地方右击菜单栏,可以看到如下几个 TOC 插件功能,前面两个是章节自动编号(用的不多),后面两个则是自动增加或者更新目录和删除目录。

该插件使用可能会有问题,其中比较常见的是目录格式异常,这是因为**该插件解析行尾是使用\n而 Vscode 的默认行尾标志是auto所以会生成异常如下。

这里解决方法很简单,通过修改 VScode 编辑器的默认行尾符号即可。编辑器左下角点击设置—进入 setting 配置—搜索 eol—修改文件行尾符号为\n即可。

这是,生成的目录格式正确且渲染正常。

这里还需要进行一些配置,主要针对一个需求:我并不需要对一级标题列入目录中,且想要手动进行目录编辑,但手动修改目录后插件会自动更新该区域。

这是因为插件默认配置目录是自动更新的,这里只需要对插件进行配置即可,具体操作如下:找到安装的插件—点击扩展配置—对打开的配置文件最后两个带auto的自动选项取消勾选。

此时就可以修改为自己需要的目录格式了

未经允许不得转载:坚果云Markdown » VScode 打造 Markdown 编辑器
分享到: 更多 (0)

坚果云Markdown轻松记录您 灵感和创意

坚果云Markdown下载坚果云Markdown介绍