Pandoc 跨平台安装与配置指南：Windows/macOS/Linux

Linux 平台安装指南

Linux 系统的安装方式因发行版而异，以下是一些常见的方法。

方法一：官方二进制包

1. 从 pandoc 的 GitHub 发布页面下载适用于 Linux 的 tarball 或 deb 包（适用于基于 Debian 的系统）。
2. 如果是 deb 包，可以使用以下命令安装：

sudo dpkg -i pandoc-*.deb

3. 如果是 tarball，可以将其解压到指定目录，例如：

tar xvzf pandoc-*.tar.gz --strip-components 1 -C /usr/local/

方法二：系统包管理器

许多 Linux 发行版的官方仓库中都包含 pandoc，你可以使用系统自带的包管理器进行安装。例如：

• Debian/Ubuntu：sudo apt-get install pandoc
• Fedora/RHEL：sudo dnf install pandoc
• Arch Linux：sudo pacman -S pandoc

注意，系统仓库中的 pandoc 版本可能不是最新的，如果你需要最新功能，建议使用官方二进制包或其他方法安装。

方法三：从源码编译安装

如果你的系统没有合适的二进制包，或者你需要自定义编译选项，可以从源码编译安装 pandoc。具体步骤如下：

1. 安装必要的依赖，包括 Haskell 编译器（GHC）和构建工具（如 stack 或 cabal）。
2. 克隆 pandoc 仓库：

git clone https://github.com/jgm/pandoc
cd pandoc

3. 使用 stack 编译安装：

stack setup
stack install pandoc-cli

或使用 cabal 编译安装：

cabal update
cabal install pandoc-cli

验证安装

安装完成后，你可以通过以下命令验证 pandoc 是否安装成功以及查看其版本：

pandoc --version

如果安装成功，命令行会输出 pandoc 的版本信息以及支持的输入输出格式列表。

为了确保 pandoc 能够正常工作，你还可以运行项目提供的测试用例。测试文件位于 test/ 目录下，包含了各种格式的输入文件和对应的预期输出文件。例如，你可以尝试将 Markdown 文件转换为 HTML：

pandoc test/markdown-citations.txt -o output.html

然后查看生成的 output.html 文件是否符合预期。

常见问题解决

问题一：命令行中找不到 pandoc

这通常是因为 pandoc 的安装目录没有添加到系统 PATH 环境变量中。你需要检查安装路径，并确保该路径已添加到 PATH 中。

问题二：生成 PDF 时出错

pandoc 默认使用 LaTeX 生成 PDF 文件，因此需要系统中安装有 LaTeX 发行版（如 MiKTeX、TeX Live、BasicTeX 等）。如果你遇到与 LaTeX 相关的错误，请确保已正确安装 LaTeX，并且必要的宏包已安装。你可以使用 --pdf-engine 选项指定其他 PDF 引擎，如 wkhtmltopdf、weasyprint 等。

问题三：Lua 过滤器无法正常工作

静态链接的 pandoc 二进制文件可能无法使用依赖于 C 语言编写的 Lua 模块的过滤器。如果你需要使用这类过滤器，建议通过包管理器（如 Homebrew、Chocolatey）或从源码编译安装 pandoc。

总结与展望

本文详细介绍了在 Windows、macOS 和 Linux 三大主流操作系统上安装 pandoc 的多种方法，包括官方安装程序、包管理器、手动安装以及从源码编译等方式。无论你是普通用户还是开发人员，都可以找到适合自己的安装方案。

安装完成后，建议你查阅 pandoc 的官方文档和社区教程，进一步探索其强大的功能，如自定义过滤器、模板设计等。项目的 README.md 文件提供了快速入门指南，而 doc/ 目录下则包含了更详细的文档。随着 pandoc 的不断发展，它将支持更多的文档格式和功能，为用户提供更便捷、高效的文档转换体验。如果你在使用过程中遇到问题或有新的需求，可以参与到 pandoc 的开源社区中，提交 issue 或贡献代码。