summaryrefslogtreecommitdiff
path: root/web/index.txt
blob: 2fc17d9d5d5c5c07ba2e439062b60d9180e6a114 (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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
% Pandoc

# Overview

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], [groff man], and [S5] HTML slide shows. 

- A real markdown parser, not based on regex substitutions.
- Modular design, using separate writers and readers for each
  supported format, for easy extensibility.
- [More accurate] and [faster], in many cases, than `Markdown.pl`.
- Multiple output formats--HTML, Docbook XML, LaTeX, reStructuredText,
  RTF, groff man pages, S5 slide shows--generated natively,
  with no XSLT postprocessing.
- Converts *to* markdown from HTML, LaTeX, and reStructuredText.
- Unicode support.
- Optional "smart" quotes, dashes, and ellipses.
- Document metadata (title, author, date).
- Inline LaTeX math and LaTeX commands.
- [ASCIIMathML] support for equations in HTML.
- Footnotes, tables, and definition lists in all output formats.
- Automatically generated tables of contents.
- Compatibility mode to turn off syntax entensions and emulate
  `Markdown.pl`.
- Convenient wrapper scripts:
    + `html2markdown` makes it easy to produce a markdown version
      of any web page.
    + `markdown2pdf` converts markdown to PDF in one step.
    + `hsmarkdown` is a drop-in replacement for `Markdown.pl`.
- Multi-platform:  runs on Windows, MacOS X, Linux, Unix.
- Free software, released under the [GPL].

To see what pandoc can do, see the [demonstration page](examples.html).

# Documentation

- [User's Guide](README.html)
- [Demonstrations](examples.html)
- Man pages
    - [`pandoc(1)`](pandoc1.html)
    - [`markdown2pdf(1)`](markdown2pdf1.html)
    - [`html2markdown(1)`](html2markdown1.html)
    - [`hsmarkdown(1)`](hsmarkdown1.html)
- [Library documentation](doc/index.html) (for Haskell programmers)
- [Instructions for installing from source](INSTALL.html)
- [Changelog](changelog)

# Downloads

- [Source tarball].
  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].
  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].
  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.

- [FreeBSD port].

- [Debian linux package] (thanks to Recai Oktaş).  
  To install, download the file and type:

        sudo dpkg -i pandoc_0.3_i386.deb

# Code 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

# Reporting bugs

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

# Mailing lists

- [pandoc-announce]:  Announcements of new releases only.
- [pandoc-discuss]:  General discussion of pandoc.

# News

- Version 0.4 released (?? July 2007).  Features:
    - list
    - of 
    - features

# Disclaimer

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

[More accurate]: http://code.google.com/p/pandoc/wiki/PandocVsMarkdownPl
[faster]: http://code.google.com/p/pandoc/wiki/Benchmarks
[ASCIIMathML]: http://www1.chapman.edu/~jipsen/mathml/asciimath.html
 
[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/
[groff man]: http://developer.apple.com/DOCUMENTATION/Darwin/Reference/ManPages/man7/groff_man.7.html
[Haskell]:  http://www.haskell.org/
[GHC]:  http://www.haskell.org/ghc/
[GPL]:  http://www.gnu.org/copyleft/gpl.html
[Source tarball]: http://code.google.com/p/pandoc/downloads/detail?name=pandoc-0.4.tar.gz "Download source tarball from Pandoc's Google Code site"
[MacOS X binary package]: http://code.google.com/p/pandoc/downloads/detail?name=pandoc-0.4.dmg "Download Mac OS X disk image from Pandoc's Google Code site"
[Windows binary package]: http://code.google.com/p/pandoc/downloads/detail?name=pandoc-0.4.zip "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]:  http://people.debian.org/~roktas/packages/pandoc_0.3_i386.deb
[FreeBSD port]: http://www.freshports.org/textproc/pandoc/
[pandoc-announce]: http://groups.google.com/group/pandoc-announce
[pandoc-discuss]: http://groups.google.com/group/pandoc-discuss