pandoc是什么 - 技术栈

Pandoc 是一款极其强大的开源文档格式转换工具，被广泛誉为文档转换界的"瑞士军刀"。它由 John MacFarlane 使用 Haskell 语言开发，主要通过命令行（CLI）运行。

简单来说，它的核心作用就是把一种文档格式完美地转换成另一种文档格式。

1. 支持的格式

Pandoc 支持极其广泛的输入和输出格式，几乎涵盖了所有主流的文本和文档类型：

轻量级标记语言：Markdown（包括多种变体）、reStructuredText、AsciiDoc、Org-mode、Textile 等。
网页格式：HTML、HTML5。
排版与出版格式：LaTeX、PDF（通常借助 LaTeX 引擎或 wkhtmltopdf 生成）、EPUB（电子书）、DocBook、FictionBook。
办公软件格式 ：Microsoft Word (.docx)、OpenOffice/LibreOffice (.odt)、PowerPoint (.pptx)。
其他格式：RTF、MediaWiki 标记、Jupyter Notebook、JATS（XML）等。

2. 主要特点

极其灵活：不仅能转换文本，还能处理图片、表格、数学公式、代码块和引文（Citations）。
高度可定制：支持自定义模板（Templates），你可以精确控制输出文档（如 Word 或 HTML）的样式、页眉页脚和结构。
过滤器（Filters）：允许用户编写脚本（如 Lua、Python）在转换过程中拦截并修改文档的内部抽象语法树（AST），实现非常高级的自定义转换逻辑。
跨平台：完美支持 Windows、macOS 和 Linux。
学术写作利器：结合 Markdown 写作和 LaTeX 排版，可以非常方便地处理参考文献并生成符合期刊要求的精美 PDF 论文。

3. 常见使用场景与命令示例

Pandoc 的基本命令语法非常直观：pandoc 输入文件 -o 输出文件

将 Markdown 转换为 Word 文档 （最常用的功能之一）：
复制代码
复制代码
```
pandoc input.md -o output.docx
```
将 Markdown 转换为 PDF （前提是系统中安装了 LaTeX 引擎，如 TeX Live 或 MacTeX）：
复制代码
复制代码
```
pandoc input.md -o output.pdf
```
将网页（HTML）逆向转换为 Markdown ：
复制代码
复制代码
```
pandoc input.html -t markdown -o output.md
```
将 Markdown 转换为 EPUB 电子书 ：
复制代码
复制代码
```
pandoc input.md -o output.epub --toc
```
(注：--toc 参数会自动生成目录)
使用自定义 Word 模板生成文档 ：
复制代码
复制代码
```
pandoc input.md -o output.docx --reference-doc=my_template.docx
```

4. 总结

如果你经常需要在不同的文档格式之间切换，或者喜欢用纯文本（如 Markdown）专注写作，但最终需要提交 Word、PDF 或发布为网页，Pandoc 是一个必不可少的效率神器。

虽然 Pandoc 本身是一个命令行工具，没有官方的图形界面，但许多知名的现代写作和笔记软件（如 Obsidian、Typora、RStudio 等）在底层导出功能中都集成或借鉴了 Pandoc 的能力。此外，社区也开发了许多基于 Pandoc 的第三方图形界面工具（如 PanWriter）供不熟悉命令行的用户使用。

怎么下载、安装pandoc

下载和安装 Pandoc 非常简单。由于它是一个跨平台的命令行工具，不同操作系统的安装方式略有不同。以下是详细的安装指南：

1. 官方下载渠道

无论使用什么系统，最权威的下载来源是 Pandoc 的 GitHub 发布页面： 👉 GitHub Releases : https://github.com/jgm/pandoc/releases (在页面底部的 "Assets" 列表中，可以找到对应系统的安装包)

2. Windows 安装

方法一：官方安装包（推荐普通用户）

打开上述 GitHub Releases 页面，下载最新的 .msi 文件（例如 pandoc-3.x.x-windows-x86_64.msi）。
双击运行下载的安装包。
按照向导提示，一路点击"Next"和"Install"即可完成安装。

方法二：使用包管理器（推荐开发者） 如果你习惯使用命令行包管理器，可以直接在 PowerShell 或 CMD 中运行：

Winget (Win10/11 自带): winget install JohnMacFarlane.Pandoc
Scoop : scoop install pandoc
Chocolatey : choco install pandoc

3. macOS 安装

方法一：使用 Homebrew（强烈推荐 Mac 用户） 如果你已经安装了 Homebrew，打开"终端"(Terminal)，输入以下命令即可一键安装：

复制代码

brew install pandoc

方法二：官方安装包

在 GitHub Releases 页面下载最新的 .pkg 文件。
- 注意：如果是 M1/M2/M3 芯片的 Mac，请下载带有 arm64 字样的版本；如果是 Intel 芯片，下载 x86_64 版本。
双击 .pkg 文件，按照系统提示完成安装。

4. Linux 安装

方法一：使用系统包管理器（最简单，但版本可能稍旧） 打开终端，根据你的发行版输入命令：

Ubuntu / Debian : sudo apt update && sudo apt install pandoc
Fedora : sudo dnf install pandoc
Arch Linux : sudo pacman -S pandoc

方法二：下载官方 .deb 包（适用于 Ubuntu/Debian 且需要最新版）

从 GitHub 下载最新的 .deb 文件（例如 pandoc-3.x.x-1-amd64.deb）。
在终端中运行：sudo dpkg -i pandoc-3.x.x-1-amd64.deb

方法三：使用 Snap

复制代码

sudo snap install pandoc

5. 验证是否安装成功

安装完成后，你需要验证系统是否能识别到 Pandoc。

Windows: 打开"命令提示符"(CMD) 或 PowerShell。
macOS / Linux: 打开"终端"(Terminal)。

输入以下命令并回车：

复制代码

pandoc --version

如果屏幕上输出了 Pandoc 的版本号（如 pandoc 3.1.11）以及一堆版权和依赖库信息，说明安装成功！

(注：如果 Windows 提示"找不到命令"，请尝试关闭当前命令行窗口重新打开，或者检查系统的环境变量 Path 中是否包含了 Pandoc 的安装路径。)

⚠️ 重要补充：关于生成 PDF 的"坑"

很多新手安装完 Pandoc 后，尝试将 Markdown 转换为 PDF（pandoc input.md -o output.pdf）时会报错。这是因为 Pandoc 本身不包含 PDF 渲染引擎。

如果你需要生成 PDF，必须额外安装一个 PDF 引擎，常见的有以下两种方案：

方案 A：安装 LaTeX 引擎（推荐，排版最精美，适合学术论文）

Windows : 下载并安装 MiKTeX 或 TeX Live。
macOS : 安装 MacTeX，或用 Homebrew 安装轻量版：brew install --cask basictex。
Linux : sudo apt install texlive texlive-xetex texlive-fonts-recommended。

方案 B：安装 wkhtmltopdf 或 weasyprint（轻量级，适合普通文档）

安装 wkhtmltopdf。
转换时加上参数指定引擎：pandoc input.md -o output.pdf --pdf-engine=wkhtmltopdf。

如果你只打算在 Markdown、Word、HTML、EPUB 等格式之间转换，则不需要安装上述任何 PDF 引擎，直接使用 Pandoc 即可。

PanWriter如何下载、安装

PanWriter 是一款专为 Pandoc 设计的图形化 Markdown 编辑器。它结合了代码编辑器的轻量感和 Pandoc 强大的转换能力，支持实时预览、语法高亮，并能直接调用 Pandoc 将文档导出为 Word、PDF、HTML 等多种格式。

⚠️ 重要前置要求

PanWriter 本身只是一个前端编辑器，它的核心转换能力完全依赖于 Pandoc。因此，在安装 PanWriter 之前，请务必确保你的电脑上已经成功安装了 Pandoc（请参考上一个回答的安装指南）。如果没有安装 Pandoc，PanWriter 的预览和导出功能将无法正常工作。

1. 官方下载渠道

PanWriter 是开源软件，最安全、最新的下载渠道是其 GitHub 发布页面： 👉 GitHub Releases : https://github.com/mb21/panwriter/releases (在页面底部的 "Assets" 列表中，找到对应你操作系统的安装包)

2. Windows 安装

在 GitHub Releases 页面，下载最新的 .exe 安装包（文件名通常类似 PanWriter-Setup-x.x.x.exe）。
双击运行下载的安装包。
按照安装向导的提示，一路点击"Next"完成安装。
安装完成后，在开始菜单或桌面找到 PanWriter 即可启动。

3. macOS 安装

在 GitHub Releases 页面，下载最新的 .dmg 镜像文件（文件名通常类似 PanWriter-x.x.x.dmg）。
- 注：如果是 M1/M2/M3 芯片的 Mac，请优先下载带有 arm64 字样的版本；Intel 芯片下载 x64 版本。
双击打开 .dmg 文件，将 PanWriter 图标拖入"应用程序 (Applications)"文件夹中。

🚨 解决 Mac 常见的"无法打开"或"已损坏"提示： 由于 PanWriter 没有经过苹果官方的开发者签名，首次打开时 macOS 可能会拦截。

方法一：右键点击 PanWriter 图标，选择"打开"，在弹出的警告窗口中再次点击"打开"。
方法二 ：如果提示"应用已损坏，打不开"，请打开"终端"(Terminal)，输入以下命令并回车（需要输入开机密码），以解除系统的安全隔离：
复制代码
复制代码
```
sudo xattr -rd com.apple.quarantine /Applications/PanWriter.app
```
执行完毕后，即可正常双击打开 PanWriter。

4. Linux 安装

Linux 用户通常使用通用的 AppImage 格式：

在 GitHub Releases 页面，下载最新的 .AppImage 文件（例如 PanWriter-x.x.x.AppImage）。
打开终端，进入下载目录，赋予该文件执行权限：
复制代码
复制代码
```
chmod +x PanWriter-x.x.x.AppImage
```
双击该文件，或者在终端中运行 ./PanWriter-x.x.x.AppImage 即可启动。 (你也可以将其移动到 /usr/local/bin 或应用程序目录中以便长期使用。)

5. 验证与基本使用

启动软件：打开 PanWriter。
检查 Pandoc 连接：在软件底部的状态栏或设置中，确认 PanWriter 是否成功识别到了系统中的 Pandoc 路径。如果显示 Pandoc 版本号，说明一切就绪。
实时预览：在左侧编写 Markdown，右侧会实时渲染预览。
导出文档 ：
- 点击顶部菜单栏的 File -> Export（或使用快捷键）。
- 选择你想要导出的格式（如 DOCX, PDF, HTML 等）。
- 注意：如果要导出 PDF，你的系统中同样需要安装 LaTeX 引擎（如 TeX Live 或 MiKTeX），这与命令行使用 Pandoc 的要求是一致的。

💡 PanWriter 的特色功能

Paginated（分页）预览：它可以像 Word 一样显示 A4 纸的页面边界和分页效果，让你在写 Markdown 时就能直观看到打印出来的排版效果。
YAML 元数据支持：完美支持在文档头部编写 YAML Front Matter（用于设置标题、作者、日期、导出模板等），并在预览中正确解析。
自定义 CSS：你可以为预览界面编写自定义 CSS，让所见即所得的效果更贴近你的最终需求。