aboutsummaryrefslogtreecommitdiff
path: root/web/index.txt
blob: 72a3594ea22e3ccd45c6d0d89cd9f4907fcda344 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
% 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],
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.

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

**Debian binary package:**  [@DEB_NAME@](@DEB_NAME@).
To install (on x86 Debian-based linux systems only), run `dpkg -i
@DEB_NAME@` as root. 

**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>.

**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.

[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
[Haskell]:  http://www.haskell.org/
[GHC]:  http://www.haskell.org/ghc/