markdown文本转换word格式

标签（空格分隔）： 编程研发

---

问题描述

markdown是目前流行且高效的科技写作格式，但是常规的工作中，word更加通用。如果要在工作场合应用markdown，那么必须解决markdown转换word的问题。

问题：给定一个markdown文档test.md，将其转换为同名word的docx文档。

工具选择

网络上现有的开源免费且通用的转换工具为pandoc，但pandoc需要在命令行下运行，对于一般的电脑使用者无疑是一个很大的门槛。

因此需要一系列的配置才能方便使用。

解决方案

文档转换

• 下载安装pandoc；
  pandoc官网，windows用于在官网下载 pandoc-1.17.0.2-windows.msi文件；
• 安装pandoc；
  默认安装，注意记住安装目录，一般在C:\Users\Frank\AppData\Local\Pandoc；
• windows环境变量中添加安装路径，以便命令行后天调用；
• 配置bat批处理文件：
  创建文本文件，写入一行代码pandoc -s test.md -o test.docx，命名为md2doc.bat；
  此批处理文件将调用pandoc将test.md转换为test.docx；
• 将需要转换的md文件与bat文件放在同一文件夹下；
• 点击md2doc.bat，闪烁cmd黑窗口，然后出现docx文件，转换成功。

环境变量路径配置

未来避免每次都输出很长的文件夹路径，我们将程序所在路径添加到windows系统的path变量中。
也就是告诉windows，当我们cmd输入pandoc时，就去相应的路径集合中寻找exe文件。

• 我的电脑—【右键】—【属性】—【高级系统 设置】—【环境变量】
• 在【系统变量】的列表中，找到【path】
• 编辑，会看到很长的一堆文件路径：

C:\ProgramData\Oracle\Java\javapath;C:\Program Files (x86)\Intel\iCLS Client\;C:\Program Files\Intel\iCLS Client\;
%SystemRoot%\system32;%SystemRoot%;%SystemRoot%\System32\Wbem;%SYSTEMROOT%\System32\WindowsPowerShell\v1.0\;
C:\Program Files\Intel\Intel(R) Management Engine Components\DAL;C:\Program Files\Intel\Intel(R) Management Engine Components\IPT

• 在后面添加CC:\Users\Frank\AppData\Local\Pandoc\ ，并注意英文分号分隔。
• 完成之后，重启生效。

应用实例

• 需要转换的md文档与bat批处理文件放入同一文件夹下；

  
  
  

  image_1aj0eurpeb4u1ld01nbj6kt16j29.png-9.6kB
• 双击md2doc.bat，转换；

• 查看转换结果：

  
  
  

  image_1aj0f1vjr1apg1uh310kf1flgufom.png-110kB