Skip to main content

使用 Pandoc

note

v2.1.7 新增。

Pandoc 是一个强大且免费的格式转换工具,你可以使用它将 Markdown 文档转换为 HTML 或者其他格式。

WonderPen 没有内置 Pandoc 工具,你可以在 Pandoc 网站 下载并安装它。目前,WonderPen 在导出为 Word 格式时,可以使用 Pandoc 工具。

下面是关于 Pandoc 的安装以及使用说明。

安装 Pandoc#

Pandoc 的安装说明位于 https://pandoc.org/installing.html,你可以从这里获取最新的下载文件以及安装说明。

下面以 2.18 为例,示范具体的安装过程。

Windows#

访问 Pandoc 位于 GitHub 上的下载页面

Pandoc 下载列表

选择对应的版本,点击下载即可。对 Windows 来说,可以下载 pandoc-2.18-windows-x86_64.msipandoc-2.18-windows-x86_64.zip 文件,两者的差别是 .msi 文件是一个安装程序,下载后需要双击安装,而 .zip 文件是一个压缩文件,下载后解压即可使用,无需安装。你可以根据自己的喜好下载相应的文件。

如果你不确定使用哪个版本,且你有当前电脑安装程序的权限,可以下载 pandoc-2.18-windows-x86_64.msi,下载完成之后,直接双击,根据提示进行安装即可。

如果你没有当前电脑安装程序的权限,或者更喜欢绿色文件,可以下载 pandoc-2.18-windows-x86_64.zip,下载完成之后解压,在解压后的文件夹中可以找到 pandoc.exe 文件,这个文件就是 Pandoc 的二进制可执行文件。

解压后的文件

将这个 pandoc.exe 文件复制到你想存储的位置即可。

macOS#

macOS 下安装 Pandoc 有两种方式,一种与上面的 Windows 类似,从 GitHub 下载页面下载安装文件并自行安装,另一种是通过 Homebrew 安装。

Homebrew 的安装命令为:

brew install pandoc

使用 Pandoc 导出为 Word 文档#

目前,WonderPen 在导出为 Word 文档时,可以使用 Pandoc 工具。

在将文档导出为 Word 格式时,默认使用内置的导出方法,这种方法能满足大多数普通文档的导出需求,但如果你的文档比较复杂(比如内置了 LaTeX 公式等),那么使用 Pandoc 导出效果可能会更好一些。你可以在导出时选择是否使用 Pandoc,如下图所示:

勾选 使用 Pandoc 选项,会显示 Pandoc 的路径信息。如果你的电脑上没有安装 Pandoc,或者你下载的是 zip 版 Pandoc 且没有将可执行文件放到系统环境变量 PATH 包含的路径中,那么 WonderPen 可能无法自动发现 Pandoc 的路径,如下图所示:

此时,你可以点击那个 设置 按钮,在弹出的对话框中,手动选择 Pandoc 可执行文件的路径。

如果一切顺利,你看到的界面将类似下图所示:

此时,点击导出按钮,即可使用 Pandoc 将选中的文档导出 Word 格式。

什么时候建议使用 Pandoc?#

Pandoc 是一款专业的文档转换工具,经过了多年的发展,功能很强大,可以处理 Markdown 中的公式,图片,链接等等。

以下是使用 Pandoc 将一个文档导出为 Word 的示例:

可以看到,导出的 Word 文档中,数学公式也可以正常显示。

如果你的 Markdown 原文只是纯文本,多数情况下使用内置的默认导出功能即可,如果原文比较复杂,比如包含表格、LaTeX 公式等情况,那么建议使用 Pandoc 导出。