在2015年,微软开源了VisualStudioCode这一轻量级的代码编辑器,从此VSCode便突飞猛进,在编程开发领域占下一席之地。事实证明,VSCode除了方便写代码,还能干更多的事情。今天我就来介绍一下如何利用VSCode,在全平台上打造一个完全免费的编写Markdown的极佳环境。
如果你在macOS上使用Homebrew包管理器,也可以使用下面的命令直接安装VSCode:
brewcaskinstallvisual-studio-code接下来Windows和macOS的操作方法一致,下面我以Windows为例进行介绍。
利用VSCode编写Markdown的最大方便之处就是它能做到「开箱即用」。你可以直接打开VSCode,快捷键Ctrl+N创建一个以.md为文件扩展名的Markdown文件,就可以开始书写Markdown了。
利用VSCode撰写Markdown文档的最佳实践是指定一个文件夹作为你的Markdown工作区,之后将你的Markdown文件全部放在这个文件夹下,然后用VSCode直接打开这个文件夹即可。
上图是一个典型的VSCodeMarkdown编辑器编辑模式的样子,其中整个编辑器分为三栏:
其中侧边栏上半部分显示的是当前工作区文件夹下的文件,包括Markdown文件和素材。下半部分可以展开「Outline」视图,即大纲,可以根据当前正在编辑的Markdown文件显示其各级标题的大纲目录。
VSCode强大之处在于其各种内置功能,统一操作这些功能的面板叫做「CommandPalette」,即「命令面板」。我们可以直接通过快捷键Ctrl+Shift+P调出命令面板,输入关键词,找到相应的命令并回车来执行。预览Markdown文件的命令叫做「Markdown:OpenPreviewtotheSide」,即「在旁边打开Markdown预览」,我们可以通过这一方式直接调出侧边的Markdown预览面板。
当然,我们也可以通过每个Markdown文件右上角的按钮直接打开侧边预览,或者通过快捷键Ctrl+KV来调出。
值得一提的是,VSCode的Markdown预览默认渲染的是当前你正在编辑的文档,不过如果你希望将某个文档的预览渲染锁定不动,可以通过「Markdown:TogglePreviewLocking」调出一个锁定某个文档的预览界面。
默认情况下,VSCode的Markdown源文件和预览界面是同步的,即你无论是在编辑界面还是预览界面滚动,另一个界面都会同步你当前浏览的位置。
这里我仅推荐我日常使用的两个插件,因为这两个插件就足以覆盖我们日常使用的绝大多数功能。
MarkdownAllinOne这个插件有着非常强大的Markdown文档辅助编写功能,下面我来一一介绍。
MarkdownAllinOne内置有上表所示的快捷键,我们可以直接利用快捷键将文字赋予格式、或进行某种操作,非常方便。
利用命令「FormatDocument」,MarkdownAllinOne可以直接帮我们将Markdown源文件中的表格进行格式化,使之更加易读。
MarkdownAllinOne可以直接帮助我们补全本地图片的路径,这个功能非常方便,因此我也推荐将Markdown文档所需的图片素材保存在一个和源文件同一个路径的文件夹下,比如这一的安排方式就比较合理:
前面的插件虽然几乎覆盖了我们日常编写Markdown几乎全部需求,但是它并没有支持Mermaid渲染引擎。由于我偶尔会使用Markdown绘制流程图、时序图或甘特图,因此我也会使用Mermaid渲染引擎来辅助我的绘制。这里MarkdownPreviewMermaidSupport这个插件就让VSCode的Markdown预览能够正确渲染Mermaid图,非常方便。
VSCode最强大的地方在于其无穷无尽的自定义功能。可能你觉得默认的Markdown预览风格并不符合你的口味,那么你可以直接在VSCode的设置中(快捷键Ctrl+,打开)自定义Markdown渲染使用的CSS样式文件:
利用VSCode在几乎任何平台上面编写Markdown文档的介绍到这里就结束了。免费开源的VSCode让Windows上也能有一个简单又漂亮的Markdown编写环境。相信经过配置,你的Markdown编写环境也一定有所提升。干杯