如何安装pandoc并实现将Markdown文档转换为Word文档

140 阅读2分钟

诸神缄默不语-个人技术博文与视频目录

1. 安装pandoc

pandoc官方下载链接:pandoc.org/installing.…

如果想下载最新版,直接从这个链接下载最新realease:github.com/jgm/pandoc/…

如果是Windows系统就下载这二者之一即可: Windows下载

我下载的是msi文件,如果由于网络原因无法下载,可以直接下这个:

我用夸克网盘给你分享了「pandoc-3.8.3-windows-x86_64.msi」,点击链接或复制整段内容,打开「夸克APP」即可获取。
/~8f683AEZAY~:/  
链接:https://pan.quark.cn/s/f0ef76911377  
提取码:2yV6

安装就直接点开就能安装了。如果需要安装到指定路径,点击Advanced选择文件夹即可。
基本一路点击确定就可以。

终端可能需要重启。如果用的是VSCode的终端,整个VSCode都要重启。

验证安装成功:
在cmd中执行:pandoc --version
正常输出内容:

pandoc 3.8.3
Features: +server +lua
Scripting engine: Lua 5.4
User data directory: C:\Users\user_name\AppData\Roaming\pandoc
Copyright (C) 2006-2025 John MacFarlane. Web:  https://pandoc.org
This is free software; see the source for copying conditions. There is no
warranty, not even for merchantability or fitness for a particular purpose.

2. 将Markdown文档转换为Word文档

1. 通过命令行直接转换

在cmd中执行:pandoc markdown_path.md -o output.docx

2. 在VSCode的MPE插件中直接转换

MPE插件指Markdown Preview Enhanced插件,是一个VSCode常用的渲染Markdown文档的插件:

MPE插件

MPE插件官方中文文档:shd101wyy.github.io/markdown-pr…
pandoc转Word部分文档:shd101wyy.github.io/markdown-pr…

需要先在想要转换的Markdown文档最前面加上:

---
title: "如何安装pandoc并实现将Markdown文档转换为Word文档"
output: word_document
---

然后在MPE浏览页面中右键选择Export - Pandoc:

导出pandoc

这个Word文档就会出现在Markdown同级文件夹下: 同级文件夹

如果想要指定Word文档路径就用path参数像这样写:

---
title: "Habits"
output:
  word_document:
    path: /Exports/Habits.docx
---

3. 注意事项

  1. pandoc的渲染能力没有MPE强,比如不支持直接换行,需要空两行再换行;另外对代码渲染效果也不好,基本上就不会渲染啊……
  2. 如果Markdown中的图床用的是URL,需要注意终端网络连通性

4. 参考资料

  1. win11安装Pandoc_pandoc安装windows11-CSDN博客
  2. Markdown文件转Word文档的多种实现方案_文心快码

image.png