pandoc安装使用(markdown转换为docx)

1.前言

Markdown(MD)是一种可以使用普通文本编辑器编辑写的标记语言，比较流行的一种书写语言格式。在互联网写作中倍受欢迎。但也有一些如微信公众号不支持markdown，但可以支持doc或是docx。这就需要将md格式的文件转换成doc或是docx格式文件。我这人比较懒，是被潮流推着走的那一位，所以使用markdown也是最近一段时间写文件才使用的，之前一直用word或是记事本之类的来写。前两天有人给了个md文档让我给更新到公众号上，随然是弄上去了，里面大概有6千左右字，30多个图片，我编辑排版从下午2:30左右弄到晚上7点左右，唉，笨者也就如我矣。过程就不此诉说了。后面又遇到同样的问题，才想是不是有更好的办法。所以就上网开始找。其实网上已经有很多类似的文章。我这里也没有啥创新的，就是做个总结汇总记录，把自己踩到的坑汇总在一起，也方便遇到跟我一样的人不用来会去查找其他资料，少走点弯路，节省点时间。

2.环境

操作系统：windows11
工具：pandoc(根据安装环境下载对应的版本，下载地址：https://github.com/jgm/pandoc/releases)

3.解压安装配置环境变量

3.1. 解压文件

解压下载的文件pandoc-2.19.2-windows-x86_64.zip，到指定的目录下打开即可使用。

3.2. 配置pandoc环境变量

此操作可以任何目录下可以执行pandoc，是需要把执行文件pandoc.exe的目录添加到系统的环境变量即可。没有此操作则只能在pandoc.exe文件目录执行。
【此电脑】->右键【属性】菜单->【系统信息的】的“高级系统设置”

【系统设置】->【环境变量】，新增“系统变量”项“PANDOC_HOME”,变量值即为pandoc.exe执行文件的目录“E:\pandoc-2.19.2-windows-x86_64\pandoc-2.19.2”(这里的目录根据实际解压文件目录填写变量值)

编辑“Path”环境变量，【新建】在Path新建一项“%PANDOC_HOME%”,即上一步操作添加的环境变量名添加上
打开终端命令，直接输入“pandoc -v”,测试环境变量是否配置成功。成功时会出现对应的信息，如下图所示显示当前的版本：

4.使用

这里以把md文件转换为docx文件为例。有两种方法:

方法一:使用快捷键"ctrl+R"输入“cmd”打开命令终端，直接进入到要转换的md文件夹下。
输入命令：

pandoc -o 性能监测工具-node-export.docx 性能监测工具-node-export.md

会发现在当前目录下生成一个《性能监测工具-node-export.docx》文件。

方法二：
创建一个bat脚本，直接执行脚本即转换成想要的文件，脚本内容：

chcp 65001
%在第一行加上“chcp 65001”，让文本用UTF8编码，否则不识别中文名称或路径%
pandoc -o 性能监测工具-node-export.docx 性能监测工具-node-export.md

5. 遇到的问题及解决办法

问题：第四节方法二时，出现执行失败，没有生成想要的docx文件。

原因：路径或文件名包含有中文字符。默认情况下，bat脚本文中不是ANSI编辑。

解决办法：
方法一：可以采用windows操作系统平台自带的词本或是nodepad++等其他文本编辑工具打开脚本文件，点击菜单【文件】-【另存为】操作，选择ANSI编码进行保存。转码后再次执行bat脚本即可。

方法二：在bat脚本的第一行加上“chcp 65001”声明更改代码页。
chcp(Change the active console code page),常见的代码映射如下表：

代码页	映射的字符集
936	GB2312
20127	US-ASCII
65001	UTF-8

6. 其他

今天还发现了一个电脑自带的截图小工具，我的是windows11，快捷键“shift+win+s”直接可以截取图片并保存到"C:\Users\ zhangsan\Pictures\Screenshots"此目录下。还可以直接编辑图片。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-sq9q5rWB-1668427036294)(F:/product/其他/md2doc-8.png)]
es\Screenshots"此目录下。还可以直接编辑图片。