使用Pandoc实现Markdown和Word文档的双向转换

前言

Word文档是老牌的文档工具，Markdown是新兴的势力。Csdn发文章就是支持Markdown文件的导入，而并不支持Word文件的导入。相反的，今日头天发文章就是支持Word文件的导入，而不支持Markdown文件的导入。

所以，这两种格式的转化还是非常有意思的。幸好目前有了第三方的转换工具的Pandoc，我试用了一下，感觉效果还是很棒的，体验如下：

一、Pandoc的安装

1.1、从官网安装

这里主要谈的是Windows下的安装。

打开官网 www.pandoc.org：

1.2、从csdn上下载

我嫌打开的比较慢，转投奔csdn上下载了一个：

下载后：

开始安装：

Finnish之后，在环境变量中，加入这个路径（c:\Program
Files\Pandoc），如下图：

然后重新启动系统。

二、转换

2.1、markdown文件转word

Markdown文件原来是这样：

转换后word文件如下：

不是很满意。如果，要将流程图自动转成图片插入的话，需要mermaid-cli环境或者用lua过滤器，就不在本文阐述了。感觉这个还不是刚需。因为流程图数量毕竟少，一般直接截图就可以了。

2.2、word文件转markdown

但是转后的效果不佳，如下图：

这样肯定不满意。

2.3、word文件转markdown图片自动保存

采用新的命令方式保存：

pandoc testconv.docx -t markdown-smart -o testconv.md --extract-media=.

打开转换后的文件testconv.md，如图：

确保图片文件也能直接存储，效果非常的棒！

在这个过程中，原来word文件中的截图，能自动保存在转换后markdown同一级的目录

Media当中，如下图：

而在md文件显示的图片只是引用的路径而已。

2.4、markdown转word文件带截图

采用命令：

pandoc testconv.md -o testconv_2.docx --extract-media=media

产生的效果：

截图能自动插入到Word文档中，效果非常棒！