Typora requires Pandoc (≥ v1.16). If you don’t have Pandoc or only old version of Pandoc is installed on your machine, you could:
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.
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.
Pandoc is a universal document text converter. Typora uses it to support file import/export features for several file types.
Briefly speaking, there are two recommended ways.
Download a package installer from Pandoc’s download page, open it and follow the instructions for installation.
For developers using Homebrew, installing Pandoc can be one line from terminal:
brew install pandoc
pandoc-*-window.msi from Pandoc’s download page, open it and follow the instructions for installation.
After Pandoc is installed, then you could import supported file types by clicking File -> Import from the menu bar, or simple drag and drop a file into Typora. Export function is also fully functional from the menu bar. Pandoc will run in background for those tasks and then exit automatically, so you may not feel it.
Versions ≥ 1.16 is required. The latest version, the better. So updating Pandoc is encouraged if your Pandoc version is too old.
Yes, only import and export (other than HTML/PDF file types) needs it.
Import supports file 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 should support more file types which Typora did not integrate, detailed info is here.
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, so, in detail:
[TOC]will be correctly exported 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.
Task list is not supported yet. Underline and highlight for
.docx is supported only if they are not used inside or outside other inline styles. Underline and highlight is not support for OpenOffice(
.odt). Embedded .gif file is not support for LaTeX. Other block or inline elements can basically be exported. But the styles cannot be 100% matched when imported or exported.
This is the instruction from Pandoc’s official site:
If you later want to uninstall the package, you can do so by downloading this script and running it with
Contact us email@example.com, better to provide a sample
.md file, so we could reproduce the bug.
If you found it is a bug/feature request for Pandoc, you could contact the community via pandoc-discuss.