TL;DR:

You may need to restart Typora after install Pandoc if you receive an error that Typora cannot find Pandoc.

For Windows users, if Typora is still saying it cannot find Pandoc, you may need to restart your PC.

# Pandoc Integration

In Typora, import function and export function for some file formats (including docx, odt, rtf, epub, LaTeX and wiki) are powered by a 3rd party software named Pandoc. Those features require Pandoc (≥ v1.16) to be installed.

Please note that installation of Pandoc is optional for Typora, if you do not need advanced import/export support in Typora, then you do not have to install Pandoc on your computer.

This document will show how to install Pandoc and use Typora with Pandoc for full import/export functions.

## What is Pandoc

Pandoc is a universal document text converter. Typora uses it to support file import/export features for several file types.

## Install Pandoc

### For Mac Users

Briefly speaking, there are two recommended ways.

##### Install from Homebrew

For developers using Homebrew, installing Pandoc can be one line from terminal:

brew install pandoc


### For Windows Users

Download the pandoc-*-window.msi from Pandoc’s download page, open it and follow the instructions for installation.

## Use Pandoc

After Pandoc is installed, then you can import supported file types by clicking File -> Import from the menu bar, or simply drag and drop a file into Typora. There are also new Export functions available from the menu bar. Pandoc will run in background for those tasks and then exit automatically, so you may not notice it.

## FAQ

#### Which version of Pandoc is supported?

Versions ≥ 1.16 are required. The latest version, the better. So updating Pandoc is encouraged if your Pandoc version is too old.

#### Can Typora work without Pandoc?

Yes. Only import and export (other than HTML/PDF file types) needs it.

#### Which file types can be imported or exported by Typora?

Import supports files with these extensions: .docx, .latex, .tex, .ltx, .rst, .rest, .org, .wiki, .dokuwiki, .textile, .opml, .epub.

Export supports file formats of: HTML, PDF (these two does not need Typora), Docx, odt, rtf, Epub, LaTeX, Media Wiki.

Pandoc itself supports more file types which Typora does not yet integrate. It has more details here.

#### What’s the difference between exporting by Typora and exporting by using Pandoc from command line?

Exporting by Typora is also powered by Pandoc, yet Typora will not convert directly from markdown to target file type, instead, it converts to an inner format Pandoc can read and then write as target file type. In detail:

• If you run Pandoc from command line, then you need to specify its markdown parser (from Pandoc Markdown, CommonMarkPHP Markdown ExtraGitHub-Flavored Markdown).
• While exporting using Typora, Typora will pass its inner AST to Pandoc for file conversion. In other words, the format of blocks or inline elements in exported output will always be consistent with what you see in Typora and exported HTML/PDF. Yet, the styling may be different.
• Some Markdown syntax extensions invented by Pandoc Markdown, like citations, are not supported when you export from Typora, as only Markdown syntax Typora supports will be correctly exported. But we may support more extended markdown syntax in future.
• [TOC] will be correctly exported from Typora for all file types. Highlight and underline will be supported for LaTeX, rtf, Epub, wiki formats and sometimes Docx. Yet, they are only supported for HTML based file formats in raw Pandoc. Other block and inline elements is basically both supported by raw Pandoc and Typora+Pandoc.

#### Can all block/inline element types be exported correctly?

Exporting Task lists are not supported yet. Underline and highlight for .docx is supported only if they are not used inside or outside other inline styles. Underlining and highlights are not support for OpenOffice(.odt). Embeddeding .gif files is not support for LaTeX. Other block or inline elements can be exported, but the styles cannot be 100% matched when imported or exported.

#### How to uninstall Pandoc for mac?

If you later want to uninstall the package, you can do so by downloading this script and running it with perl uninstall-pandoc.pl”.

#### Found a bug and unsupported syntax for exporting?

Contact us [email protected], and please provide a sample .md file, so we can reproduce the bug.