Pandoc 是一款通用标记转换器，支持 Markdown、HTML、PDF 等多种格式互转。本文介绍了在 Windows、macOS 和 Linux 系统下的多种安装方法，包括官方安装包、包管理器（Chocolatey/Homebrew/apt）及源码编译。内容涵盖环境验证、LaTeX 配置以支持 PDF 生成，以及常见问题排查，帮助用户快速完成工具部署。
Pandoc 是一款功能强大的Universal markup converter（通用标记转换器），支持超过 40 种文档格式的相互转换，包括 Markdown、HTML、LaTeX、Word（docx）、EPUB 等。它被广泛应用于学术写作、电子书制作、网站开发等场景，是开源社区中文档处理的重要工具。详细安装说明可参考官方文档。
Windows 系统下有多种安装 pandoc 的方式，你可以根据自己的需求选择最适合的方法。
如果你已经安装了 Chocolatey 包管理器，可以通过以下命令快速安装 pandoc：
choco install pandoc
此外，你还可以安装一些与 pandoc 配合使用的工具，如用于处理 SVG 图片的 librsvg、用于运行过滤器的 Python 以及用于生成 PDF 的 MiKTeX：
choco install rsvg-convert python miktex
Windows 10 及以上版本内置了 winget 包管理器，你可以使用以下命令安装 pandoc：
winget install --source winget --exact --id JohnMacFarlane.Pandoc
C:\Program Files\pandoc。macOS 用户同样有多种安装 pandoc 的选择。
perl uninstall-pandoc.pl。Homebrew 是 macOS 上常用的包管理器，使用以下命令安装 pandoc：
brew install pandoc
你还可以安装一些推荐的辅助工具：
brew install librsvg python homebrew/cask/basictex
其中，basictex 是一个轻量级的 LaTeX 发行版，用于生成 PDF 文件。如果在使用过程中遇到字体相关的错误，可以运行以下命令安装推荐的字体集：
tlmgr install collection-fontsrecommended
如果你使用 MacPorts，可以通过以下命令安装 pandoc：
port install pandoc
Linux 系统的安装方式因发行版而异，以下是一些常见的方法。
sudo dpkg -i pandoc-*.deb
tar xvzf pandoc-*.tar.gz --strip-components 1 -C /usr/local/
许多 Linux 发行版的官方仓库中都包含 pandoc，你可以使用系统自带的包管理器进行安装。例如：
sudo apt-get install pandocsudo dnf install pandocsudo pacman -S pandoc注意，系统仓库中的 pandoc 版本可能不是最新的，如果你需要最新功能，建议使用官方二进制包或其他方法安装。
如果你的系统没有合适的二进制包，或者你需要自定义编译选项，可以从源码编译安装 pandoc。具体步骤如下：
git clone https://github.com/jgm/pandoc
cd pandoc
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 的安装目录没有添加到系统 PATH 环境变量中。你需要检查安装路径，并确保该路径已添加到 PATH 中。
pandoc 默认使用 LaTeX 生成 PDF 文件，因此需要系统中安装有 LaTeX 发行版（如 MiKTeX、TeX Live、BasicTeX 等）。如果你遇到与 LaTeX 相关的错误，请确保已正确安装 LaTeX，并且必要的宏包已安装。你可以使用 --pdf-engine 选项指定其他 PDF 引擎，如 wkhtmltopdf、weasyprint 等。
静态链接的 pandoc 二进制文件可能无法使用依赖于 C 语言编写的 Lua 模块的过滤器。如果你需要使用这类过滤器，建议通过包管理器（如 Homebrew、Chocolatey）或从源码编译安装 pandoc。
本文详细介绍了在 Windows、macOS 和 Linux 三大主流操作系统上安装 pandoc 的多种方法，包括官方安装程序、包管理器、手动安装以及从源码编译等方式。无论你是普通用户还是开发人员，都可以找到适合自己的安装方案。
安装完成后，建议你查阅 pandoc 的官方文档和社区教程，进一步探索其强大的功能，如自定义过滤器、模板设计等。项目的 README.md 文件提供了快速入门指南，而 doc/ 目录下则包含了更详细的文档。随着 pandoc 的不断发展，它将支持更多的文档格式和功能，为用户提供更便捷、高效的文档转换体验。如果你在使用过程中遇到问题或有新的需求，可以参与到 pandoc 的开源社区中，提交 issue 或贡献代码。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online