7 使用 vscode 编写 word 文档的一个实例

您还在苦苦的为 word 的编写手忙脚乱吗？您还在为修改 word 的文件格式，让它符合公司、学习乃至论文的模板而苦恼吗？那么，本文的教程将为您打开一个新的世界！我们将使用 Markdown 来编写 word 文档，具体的 Markdown 的使用语法可查看我的文集一个程序员的自我成长笔记。

注意：本文的使用平台是 Windows10，Ubuntu 和 Mac 系统应该也可以，只是安装的软件包需要您自己搜索。

首先，我们需要安装 Pandoc 和 vscode（具体教程见我的另一篇博文第 5 章 vscode + MPE + pandoc 处理 office），如果您需要大量的数学公式编辑，那么，您最好也将 Tex Live 安装了。

其次，您需要安装 vscode 的 MPE 插件。下载地址：👓 Markdown Preview Enhanced。点击 Install 便会帮您自动安装到 vscode 的。

最后，您便可以愉快的编写 word 文档了。

具体该怎么写呢？其实也很简单。

第1步：在您的电脑磁盘上创建一个空的目录，用来当作您以后的写作空间。比如：
我在我的本地磁盘创建一个空目录 test。然后使用 vscode 打开该空目录。实例图见图1：

图1 vscode 打开 test 目录后的示意图

第2步：为了我们方便管理写作的空间，我们可以将该写作空间保存在您的桌面图标。

图2 保存工作区

在弹出的界面选择您要保存的位置，比如桌面，然后输入该工作区的名字，可参考图3：

图3 为工作区取名字

接着，您便可以在您保存的位置看到您的工作区了。比如：

图4 桌面上的工作区

最后您双击该工作区的图标，便可以打开之前的工作环境了，并且此时该工作区被 vscode 显性的突出了：

图5 vscode 凸显的工作区

vscode 提供的工作区的功能是很强大的，它不仅仅让您管理您刚刚创建的目录的文档，它也可管理不同磁盘的文档，比如说，之前我创建的目录 test 是在 E 盘的，但是我想要将 D 盘的文档也纳入到 test 工作区之中进行管理，我可以像图6 这样做：

图6 将其他目录纳入到您的工作区

在新弹出的界面选择您要添加的目录即可。具体可参考图7：

图7 选择新的目录纳入到工作区

我再次看看我们的工作区：

图8 新的工作区展示

在图8 中是不是已经加入了新的目录？这样一来，在您的工作区编写文档，将不受限于文档所在的目录乃至磁盘。您也许会说，这没有什么新意呀，作用不大啊。这么想您就错了。因为，vscode 提供了很多强大的文件管理功能。比如，支持拖曳，您可以在同一个工作区将不同的文档拖曳到不同的目录之中（当然也支持复制），甚至您还可以从工作区外面将图片等文件直接拖曳进您的工作区之中。是不是很强大？😼还有一些其他功能，您自己摸索！

好了，闲话到此为止，我们回到正题上来。

第3步：我们还回到之前创建的空目录下，然后创建一个新的文件 _output.yaml，并写入如下内容：

output:
  word_document:
    reference_doc: demo.docx
    highlight: "tango"

创建该文件的目的是让所有在该文件同级的 Markdown 文档的输出格式都是一个 word 模板。word 模板？对的，您还需要放入一个已经设置好的或者其他人或者组织提供给您的 word 模板，并将其改名为 demo.docx（您不改名也是可以的，只需要将其替换为您的模板文件名即可）。还有一个参数 highlight 是用来对您的代码进行渲染的格式，如何您想要使用其他风格，可在终端输入 pandoc --list-highlight-styles 获取 Pandoc 支持的所有风格。

第4步：设置 Markdown 的输出格式为 word，且支持自动保存功能。即在您新创建的 Markdown 文件之中添加如下内容在开头：