- There is a package installer at pandoc’s download page.
- For PDF output, you’ll also need to install LaTeX. We recommend MiKTeX.
Mac OS X
- There is a package installer at pandoc’s download page. If you later want to uninstall the package, you can do so by downloading this script and running it with
For PDF output, you’ll also need LaTeX. Because a full MacTeX installation takes more than a gigabyte of disk space, we recommend installing BasicTeX (64M), and using the
tlmgrtool to install additional packages as needed. If you get errors warning of fonts not found, try
tlmgr install collection-fontsrecommended
For 64-bit Debian and Ubuntu, we provide a debian package on the download page. This will install the
pandoc-citeprocexecutables and man pages. If you use an RPM-based distro, you may be able to install this deb using
alien, or try
ar p $DEB data.tar.gz | sudo tar xvz --strip-components 2 -C /usr/local
$DEBis the path to the downloaded deb.
- Or, try your package manager. Pandoc is in the Debian, Ubuntu, Slackware, Arch, Fedora, NiXOS, openSUSE, and gentoo repositories. Note, however, that versions in the repositories are often old.
- If the version in your repository is too old and you cannot use the deb we provide, you can install from source, using the instructions below under Installing from source. Note that most distros have the Haskell platform in their package repositories. For example, on Debian/Ubuntu, you can install it with
apt-get install haskell-platform.
For PDF output, you’ll need LaTeX. We recommend installing TeX Live via your package manager. (On Debian/Ubuntu,
apt-get install texlive.)
Installing from source
If for some reason a binary package is not available for your platform, you can install from source:
First, install the Haskell platform, then use the
cabaltool to get the latest release of pandoc:
cabal update cabal install pandoc
Or, if you want to use pandoc’s citation processing features,
cabal update cabal install pandoc pandoc-citeproc
This will download and compile pandoc and all of its dependencies.
If this step fails, and you’re using an older version of the Haskell Platform (e.g. in Debian stable), try upgrading your
cabal install cabal-install ~/.cabal/bin/cabal update ~/.cabal/bin/cabal install pandoc
By default, cabal will perform a user install, putting the pandoc executable in
~/.cabal/bin(on linux and BSD) or
~/Library/Haskell/bin(on OS X). Make sure this directory is in your path.
To update pandoc when a new release comes out on HackageDB, simply do
cabal update && cabal install pandocagain. You may get a message saying that the install may break earlier installations of pandoc and pandoc-citeproc. It should be safe to force the installation:
cabal install --force pandoc pandoc-citeproc
Alternatively, you can download the source tarball and follow the instructions in INSTALL.
Creating a relocatable binary
It is possible to compile pandoc such that the data files pandoc uses are embedded in the binary. (The executables in the binary are built this way.) The resulting binary can be run from any directory and is completely self-contained.
cabal update cabal install hsb2hs cabal install --flags="embed_data_files" pandoc pandoc-citeproc