安装和使用 Pandoc

Typora 的一些高级功能需要 Pandoc (opens new window) 。如果你没有 Pandoc（或版本早于 v2.0），请从 Pandoc Download Page (opens new window) 下载并运行安装程序。

如果你收到 Typora 找不到 Pandoc 的错误，你可能需要在安装 Pandoc 后重新启动 Typora。

对于 Windows 用户，如果 Typora 仍然说找不到 Pandoc，你可能需要重新启动你的电脑。

Pandoc 整合

在 Typora 中，一些文件格式（包括 docx、odt、rtf、epub、LaTeX 和 wiki）的导入功能和导出功能是由一个名为 Pandoc 的第三方软件提供的。这些功能需要安装 Pandoc（≥ v2.0）。

请注意，对于 Typora 来说，安装 Pandoc 是可选的，如果你不需要 Typora 中的高级导入/导出支持，那么你就不必在你的电脑上安装 Pandoc。

本文将介绍如何安装 Pandoc 并将 Typora 与 Pandoc 一起使用，实现完整的导入/导出功能。

什么是 Pandoc

Pandoc (opens new window) 是一个通用的文件文本转换器。Typora 用它来支持几种文件类型的文件导入/导出功能。

安装 Pandoc

对于 Mac 用户

简而言之，有两种推荐方式。

从下载的软件包安装程序进行安装

从 Pandoc 的 download page (opens new window) ，下载一个软件包的安装程序，打开它，按照说明进行安装。

从自制软件中安装

对于使用 Homebrew (opens new window) 的开发者来说，安装 Pandoc 可以在终端机上只用一行。

brew install pandoc

对于 Windows 用户

从 Pandoc 的 download page (opens new window)，下载 pandoc-*-window.msi，打开后按照说明进行安装。

通过 Winget 安装

对于 Windows 11 用户，你也可以通过 cmd 中的 winget install pandoc 进行安装。

为 Linux 安装

你可以在终端通过 sudo apt install pandoc 来安装 pandoc。

如果你使用的是 Snap (opens new window) 版本的 Typora，pandoc 就包含在 snap 中。

配置 Pandoc 路径

如果安装了 pandoc 之后，Typora 仍然显示 "需要 Pandoc 才能继续"，请尝试重启 Typora。如果重启后 Typora 仍然找不到 pandoc，你可以在 Preferences Panel → 导出 → General 手动输入 pandoc 路径。

使用 Pandoc

安装 Pandoc 后，那么你可以通过点击菜单栏中的文件-> 导入来导入支持的文件类型，或者直接将文件拖放到 Typora 中。还有新的导出功能可从菜单栏中获得。Pandoc 会在后台运行这些任务，然后自动退出，所以你可能不会注意到它。

问答

支持哪个版本的 Pandoc？

需要≥ 2.0 的版本。最新的版本越多越好。因此，如果你的 Pandoc 版本太老，鼓励你更新 Pandoc。

你可以通过以下方式检查你的 pandoc 版本

pandoc --version

没有 Pandoc，Typora 能工作吗？

是的。只有进口和导出（除 HTML/PDF 文件类型外）需要它。

Typora 可以导入或导出哪些文件类型？

导入支持这些扩展名的文件：.docx, .latex, .tex, .ltx, .rst, .rest, .org, .wiki, .dokuwiki, .textile, .pml, .epub。

导出支持的文件格式有 HTML、PDF（这两种不需要 Typora）、Docx、odt、rtf、Epub、LaTeX、Media Wiki。

Pandoc 本身支持更多的文件类型，而 Typora 还没有整合。它有更多的细节 here (opens new window) 。

用 Typora 导出和用 Pandoc 从命令行导出有什么区别？

通过 Typora 导出也是由 Pandoc 支持的，然而 Typora 不会直接从 markdown 转换为目标文件类型，相反，它会转换为 Pandoc 可以读取的内部格式，然后写成目标文件类型。详细来说。

• 如果你从命令行运行 Pandoc，那么你需要指定它的 markdown 解析器（从 Pandoc Markdown,CommonMark (opens new window),PHP Markdown Extra (opens new window),GitHub-Flavored Markdown (opens new window) ）。
• 在使用 Typora 进行输出时，Typora 会将其内部的 AST 传递给 Pandoc 进行文件转换。换句话说，输出的块或内联元素的格式将始终与你在 Typora 和导出的 HTML/PDF 中看到的一致。然而，样式可能会有所不同。
• 当你从 Typora 导出时，不支持 Pandoc Markdown 发明的一些 Markdown 语法扩展，如引文，因为只有 Typora 支持的 Markdown 语法才会被正确导出。但我们将来可能会支持更多的扩展 Markdown 语法。
• [TOC] 将正确地从 Typora 导出所有文件类型。LaTeX、rtf、Epub、wiki 格式以及有时 Docx 都将支持高亮和下划线。然而，它们只支持原始 Pandoc 中基于 HTML 的文件格式。其他块状和内联元素基本上由原始 Pandoc 和 Typora+Pandoc 都支持。

所有的块/内联元素类型都能正确导出吗？

目前还不支持导出任务列表。.docx 的下划线和高亮只有在它们不在其他内联样式内部或外部使用时才被支持。OpenOffice( .odt) 不支持下划线和高亮。LaTeX 不支持嵌入.gif 文件。其他块状或内联元素可以被导出，但在导入或导出时样式不能 100% 匹配。

如何卸载 Pandoc for mac？

按照 Pandoc’s official instructions (opens new window) 。

如果你后来想卸载软件包，你可以通过下载 this script (opens new window)，然后用 perl uninstall-pandoc.pl "运行它来实现。

发现了一个错误和不支持的导出语法？

请与我们联系 [email protected]，并请提供一个样本 .md 文件，以便我们能够重现该错误。

如果你有关于 Pandoc 的错误/功能请求，请通过 pandoc-discuss (opens new window) 与其社区联系。