安装和使用Pandoc

by Typora.net

Typora需要Pandoc才能使用某些高级功能。如果您没有Pandoc(或版本低于v1.16),请从Pandoc下载页面下载并运行安装程序。

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

对于Windows用户,如果Typora仍说无法找到Pandoc,则可能需要重新启动PC。

Pandoc整合

在Typora中,某些文件格式(包括docx,odt,rtf,epub,LaTeX和wiki)的导入和导出功能由名为Pandoc的第三方软件提供支持。这些功能需要安装Pandoc(≥v1.16)。

请注意,对于Typora,Pandoc的安装是可选的,如果您不需要Typora中的高级导入/导出支持,则不必在计算机上安装Pandoc。

本文档将展示如何安装Pandoc以及将Typora与Pandoc一起使用以实现完整的导入/导出功能。

什么是Pandoc

Pandoc  是通用文档文本转换器。Typora使用它来支持几种文件类型的文件导入/导出功能。

安装Pandoc

对于Mac用户

简而言之,有两种建议的方法。

从下载的软件包安装程序中安装

从Pandoc的下载页面下载软件包安装程序  ,打开它,然后按照说明进行安装。

片段20160502_1
从Homebrew安装

对于使用Homebrew的开发人员,安装Pandoc可以从终端执行以下操作:

brew install pandoc

对于Windows用户

下载pandoc-*-window.msi从Pandoc的  下载页面,打开它,然后按照说明进行安装。

潘多克赢

使用Pandoc

在安装Pandoc之后,您可以通过从菜单栏中单击“文件”->“导入”来导入支持的文件类型,或者只是将文件拖放到Typora中。菜单栏中还提供了新的导出功能。Pandoc将在这些任务的后台运行,然后自动退出,因此您可能不会注意到它。

常问问题

支持哪个版本的Pandoc?

要求版本≥1.16。最新版本,更好。因此,如果您的Pandoc版本太旧,则鼓励更新Pandoc。

Typora是否可以在没有Pandoc的情况下工作?

是。只有导入和导出(HTML / PDF文件类型除外)才需要它。

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

导入支持具有以下扩展名的文件:.docx,.latex,.tex,.ltx,.rst,.rest,.org,.wiki,.dokuwiki,.textile,.opml,.epub。

导出支持以下文件格式:HTML,PDF(这两个不需要Typora),Docx,odt,rtf,Epub,LaTeX,Media Wiki。

Pandoc本身支持Typora尚未集成的更多文件类型。在这里有更多详细信息。

通过Typora导出与通过命令行使用Pandoc导出之间有什么区别?

Typora导出还由Pandoc提供支持,但是Typora不会直接从markdown转换为目标文件类型,而是转换为Pandoc可以读取然后写入为目标文件类型的内部格式。详细地:

是否可以正确导出所有块/内联元素类型?

尚不支持导出任务列表。.docx仅当未在其他内联样式的内部或外部使用下划线和突出显示时,才支持下划线和突出显示。下划线和突出显示不支持OpenOffice(.odt)。LaTeX不支持嵌入.gif文件。可以导出其他块或内联元素,但是在导入或导出时样式不能100%匹配。

如何为Mac卸载Pandoc?

请遵循Pandoc的官方指示

如果以后要卸载软件包,可以通过下载  此脚本  并使用来运行它  perl uninstall-pandoc.pl


Tags: