1. 問題描述
用過markdown的朋友都知道，markdown語法簡潔，寫作效率極高，非常適合網(wǎng)絡(luò)博客、郵件、筆記等非正式文檔的寫作。但對于格式復(fù)雜的正式報(bào)告、論文、項(xiàng)目計(jì)劃書等正式文檔是不適合的，無法滿足精細(xì)排版的要求。
解決這一矛盾的基本思路是，在markdown中寫作完成初稿，之后在word中進(jìn)行精細(xì)化排版設(shè)置。這就需要markdown轉(zhuǎn)換word。以前一直沒有找到合適的工具，今天終于發(fā)現(xiàn)了一個(gè)理想的工具：Writage。
2. 技術(shù)背景
Writage是一款word插件，下載網(wǎng)址為：http://www.writage.com/。
- 功能：支持markdown與word互相轉(zhuǎn)換
- 安裝：
- Writage，word插件
- Pandoc，文檔轉(zhuǎn)換后臺(tái)軟件
實(shí)際上實(shí)現(xiàn)文檔格式轉(zhuǎn)換的是pandoc軟件，Writage作為word插件，將pandoc的功能集成到了word選項(xiàng)中，避免了繁瑣的cmd 命令操作。
3. 解決方案
安裝Writage和Pandoc軟件后，word中不會(huì)直接出現(xiàn)選項(xiàng)卡，但在【打開】和【保存】的對話框中會(huì)出現(xiàn)相關(guān)的選項(xiàng)，如下：
3.1 markdown轉(zhuǎn)換word
-
通過word軟件打開markdown文件實(shí)現(xiàn)：
- 打開原markdown文檔后，另存為word格式即可；
3.1 word轉(zhuǎn)換markdown
- 首先設(shè)置word文檔中的標(biāo)準(zhǔn)樣式，如一級、二級標(biāo)題等，如此才能與markdown的格式對應(yīng)；
-
word格式另存為markdown；
4. 實(shí)施示例
4.1 插件安裝
- 下載軟件：http://www.writage.com/
- 分別安裝軟件，全部按照默認(rèn)安裝即可
- 重啟電腦
4.2 markdown轉(zhuǎn)換word
-
創(chuàng)建markdown文檔，可以在任意編輯器，如cmd markdown
- 導(dǎo)出markdown文本文檔
-
word軟件打開markdown
-
word中markdown文檔的預(yù)覽效果如下
由于markdown中的圖片無法設(shè)置大小，因此在word中排布的圖片格式不標(biāo)準(zhǔn)，需要人工調(diào)整。其他格式，如一級、二級標(biāo)題，項(xiàng)目列表等基本沒有問題。
- 調(diào)整格式后，即可保存為word、pdf等格式
4.3 word轉(zhuǎn)換markdown
直接另存為markdown格式即可：
各級標(biāo)題的設(shè)置，實(shí)際上在markdown編輯器中更方便修改設(shè)置。
5. 常見問題
markdown轉(zhuǎn)換word的過程中，尤其需要注意的問題是：圖片的下載和存儲(chǔ)。
5.1 markdown轉(zhuǎn)換word
在原生的markdown文檔中，圖片以網(wǎng)絡(luò)超鏈接的形式保存：
以上的網(wǎng)址即為圖片的網(wǎng)絡(luò)路徑，如果markdown文檔中有這一類圖片，那么需要在網(wǎng)絡(luò)連接的情況下，才能正常輸出有圖片的word文檔。否則，圖片處顯示空白。
5.2 word轉(zhuǎn)換markdown
word轉(zhuǎn)換markdown之后，文檔中的圖片輸出到本地文件夾media下：
文件夾與輸出的markdown文檔在同一目錄下:
在markdown中圖片引用本地相對路徑：
！[](media/3dd1ad6de3e0a437694573143f0c8944.png)
故必須保證markdown與media文件夾在一起，才能完整的在markdown編輯器中顯示圖片。
本文用時(shí) 35 m
