您還在苦苦的為 word 的編寫手忙腳亂嗎？您還在為修改 word 的文件格式，讓它符合公司、學(xué)習(xí)乃至論文的模板而苦惱嗎？那么，本文的教程將為您打開一個新的世界！我們將使用 Markdown 來編寫 word 文檔，具體的 Markdown 的使用語法可查看我的文集 一個程序員的自我成長筆記。

注意：本文的使用平臺是 Windows10，Ubuntu 和 Mac 系統(tǒng)應(yīng)該也可以，只是安裝的軟件包需要您自己搜索。

首先，我們需要安裝 Pandoc 和 vscode（具體教程見我的另一篇博文第 5 章 vscode + MPE + pandoc 處理 office），如果您需要大量的數(shù)學(xué)公式編輯，那么，您最好也將 Tex Live 安裝了。

其次，您需要安裝 vscode 的 MPE 插件。下載地址：?? Markdown Preview Enhanced。點(diǎn)擊 Install 便會幫您自動安裝到 vscode 的。

最后，您便可以愉快的編寫 word 文檔了。

具體該怎么寫呢？其實(shí)也很簡單。

第1步：在您的電腦磁盤上創(chuàng)建一個空的目錄，用來當(dāng)作您以后的寫作空間。比如：
我在我的本地磁盤創(chuàng)建一個空目錄 test。然后使用 vscode 打開該空目錄。實(shí)例圖見圖1：

圖1 vscode 打開 test 目錄后的示意圖

第2步：為了我們方便管理寫作的空間，我們可以將該寫作空間保存在您的桌面圖標(biāo)。

圖2 保存工作區(qū)

在彈出的界面選擇您要保存的位置，比如桌面，然后輸入該工作區(qū)的名字，可參考圖3：

圖3 為工作區(qū)取名字

接著，您便可以在您保存的位置看到您的工作區(qū)了。比如：

圖4 桌面上的工作區(qū)

最后您雙擊該工作區(qū)的圖標(biāo)，便可以打開之前的工作環(huán)境了，并且此時該工作區(qū)被 vscode 顯性的突出了：

圖5 vscode 凸顯的工作區(qū)

vscode 提供的工作區(qū)的功能是很強(qiáng)大的，它不僅僅讓您管理您剛剛創(chuàng)建的目錄的文檔，它也可管理不同磁盤的文檔，比如說，之前我創(chuàng)建的目錄 test 是在 E 盤的，但是我想要將 D 盤的文檔也納入到 test 工作區(qū)之中進(jìn)行管理，我可以像圖6 這樣做：

圖6 將其他目錄納入到您的工作區(qū)

在新彈出的界面選擇您要添加的目錄即可。具體可參考圖7：

圖7 選擇新的目錄納入到工作區(qū)

我再次看看我們的工作區(qū)：

圖8 新的工作區(qū)展示

在圖8 中是不是已經(jīng)加入了新的目錄？這樣一來，在您的工作區(qū)編寫文檔，將不受限于文檔所在的目錄乃至磁盤。 您也許會說，這沒有什么新意呀，作用不大啊。這么想您就錯了。因?yàn)?，vscode 提供了很多強(qiáng)大的文件管理功能。比如，支持拖曳，您可以在同一個工作區(qū)將不同的文檔拖曳到不同的目錄之中（當(dāng)然也支持復(fù)制），甚至您還可以從工作區(qū)外面將圖片等文件直接拖曳進(jìn)您的工作區(qū)之中。是不是很強(qiáng)大？??還有一些其他功能，您自己摸索！

好了，閑話到此為止，我們回到正題上來。

第3步：我們還回到之前創(chuàng)建的空目錄下，然后創(chuàng)建一個新的文件 _output.yaml，并寫入如下內(nèi)容：

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

創(chuàng)建該文件的目的是讓所有在該文件同級的 Markdown 文檔的輸出格式都是一個 word 模板。word 模板？對的，您還需要放入一個已經(jīng)設(shè)置好的或者其他人或者組織提供給您的 word 模板，并將其改名為 demo.docx（您不改名也是可以的，只需要將其替換為您的模板文件名即可）。還有一個參數(shù) highlight 是用來對您的代碼進(jìn)行渲染的格式，如何您想要使用其他風(fēng)格，可在終端輸入 pandoc --list-highlight-styles 獲取 Pandoc 支持的所有風(fēng)格。

第4步：設(shè)置 Markdown 的輸出格式為 word，且支持自動保存功能。即在您新創(chuàng)建的 Markdown 文件之中添加如下內(nèi)容在開頭：

---
export_on_save:
  pandoc: true
---

具體效果可見圖9例：

圖9 寫文章的自動保存和轉(zhuǎn)換

只要您設(shè)置了 vscode 的文件自動保存，即：

圖 10 文件自動保存的設(shè)置

那么，您以后只需要關(guān)注如何在 .md 文件中編寫文字即可，具體的排版 vscode 與 Pandoc 會自動幫您完成的。因?yàn)椋灰?.md 文檔有所改動，那么便會實(shí)時的在對應(yīng)的 word 文檔之中有所更新。您可以看看圖11 的效果：

圖11 自動生成 word 的示意圖

對比圖11，與圖10 相比，因?yàn)槟砑恿诵碌膬?nèi)容，文件內(nèi)容有所改變，所以，在該目錄下生成了新的同名 word 文檔，該文檔保留了 demo.docx 的風(fēng)格，而內(nèi)容卻是 .md 文檔的內(nèi)容。

這樣就結(jié)束了嗎？為了讓文檔的編輯更加有條理，您可以將不同的章節(jié)寫在不同的 Markdown 文件之中，然后像下圖這樣組織它們：

圖12 使用 import 組織不同的章節(jié)

是不是很方便？如果您想要改變章節(jié)的順序，只需要將 @import "第3章.md" 這樣的語句改變順序即可。

至此，本文就介紹到這。希望本文給您帶來幫助。