% Pandoc

Pandoc is a [Haskell] library for converting from one markup format
to another, and a command-line tool that uses this library. It can read
[markdown] and (subsets of) [reStructuredText], [HTML], and [LaTeX],
and it can write [markdown], [reStructuredText], [HTML], [LaTeX], [RTF],
[DocBook XML], and [S5] HTML slide shows. Pandoc's version of markdown
contains some enhancements, like footnotes and embedded LaTeX.

In contrast to existing tools for converting markdown to HTML, which
use regex substitutions, Pandoc has a modular design: it consists of a
set of readers, which parse text in a given format and produce a native
representation of the document, and a set of writers, which convert
this native representation into a target format. Thus, adding an input
or output format requires only adding a reader or writer.

For more information, see the [README](README.html) file.

Pandoc is free software, released under the [GPL].

**Source distribution:** [`@TARBALL_NAME@`].
To install, unpack the archive and follow the instructions in the
[INSTALL](INSTALL.html) file. You'll need the [GHC] Haskell compiler,
version 6.6 or higher.

**MacOS X binary package:** [`@OSX_DMG_NAME@`].
To install, just double-click the package icon in the disk
image.  See the [installation notes](osx-notes.html) for important
information about setting your `PATH`.  Note:  This package was
compiled on a G4 Mac; it will also work on an Intel Mac via emulation.

**Windows binary package:**  [`@WINDOWS_PKG_NAME@`].
The zip file contains the `pandoc.exe` command-line program (which
you should extract from the zip archive and put somewhere in your
PATH).  See the included file `README-WINDOWS.txt` for instructions
on using the program.  Note:  If you use [Cygwin], we recommend that
you compile Pandoc from source.  This will give you access to the
wrapper scripts `markdown2pdf`, `html2markdown`, and `hsmarkdown`,
which are not included in the Windows binary package.

[`@TARBALL_NAME@`]: http://code.google.com/p/pandoc/downloads/detail?name=@TARBALL_NAME@
  "Download source tarball from Pandoc's Google Code site"
[`@OSX_DMG_NAME@`]: http://code.google.com/p/pandoc/downloads/detail?name=@OSX_DMG_NAME@
  "Download Mac OS X disk image from Pandoc's Google Code site"
[`@WINDOWS_PKG_NAME@`]: http://code.google.com/p/pandoc/downloads/detail?name=@WINDOWS_PKG_NAME@
  "Download Windows zip file from Pandoc's Google Code site"
[Cygwin]: http://www.cygwin.com/
  "Cygwin - a linux-like environment for Windows"

**Debian linux package:**  [`pandoc_0.3_i386.deb`] (thanks to Recai Oktaş).  
To install, download the file and type:

    sudo dpkg -i pandoc_0.3_i386.deb

[`pandoc_0.3_i386.deb`]:  http://people.debian.org/~roktas/packages/pandoc_0.3_i386.deb

**FreeBSD port:**  <http://www.freshports.org/textproc/pandoc/>

**Repository:**  Pandoc has a publicly accesible subversion repository
at Google Code (<http://code.google.com/p/pandoc>).  To check out the
latest, bleeding-edge source code:

        svn checkout http://pandoc.googlecode.com/svn/trunk/ pandoc

**Bugs:**  You may view existing bug reports and submit new ones at 
<http://code.google.com/p/pandoc/issues/list>.

**Announcements list:**  If you'd like to receive announcements of
new releases of Pandoc, you may subscribe to the [pandoc-announce
mailing list].

**API:**  You can browse the API documentation for the Pandoc Haskell
libraries [here](doc/index.html).

This is an early, "alpha" release. It carries no warranties of any
kind.

[pandoc-announce mailing list]: http://groups.google.com/group/pandoc-announce
[John MacFarlane]: http://sophos.berkeley.edu/macfarlane/
[markdown]: http://daringfireball.net/projects/markdown/
[reStructuredText]: http://docutils.sourceforge.net/docs/ref/rst/introduction.html
[S5]: http://meyerweb.com/eric/tools/s5/
[HTML]:  http://www.w3.org/TR/html40/
[LaTeX]:  http://www.latex-project.org/
[RTF]:  http://en.wikipedia.org/wiki/Rich_Text_Format
[DocBook XML]: http://www.docbook.org/
[Haskell]:  http://www.haskell.org/
[GHC]:  http://www.haskell.org/ghc/
[GPL]:  http://www.gnu.org/copyleft/gpl.html