d829c4820a
Summary of main changes: + Added -o/--output and -d/--debug options to pandoc. + Modified pandoc to behave differently depending on the name of the program. For example, if the program name is 'html2latex', the default reader will be html and the default writer latex. + Removed most of the old wrappers, replacing them with symlinks to pandoc. + Rewrote markdown2pdf and created a new wrapper web2markdown, with the functionality of the old html2markdown script. These new scripts exploit pandoc's -d option to avoid having to do complex command-line parsing. + Revised man pages and documentation appropriately. git-svn-id: https://pandoc.googlecode.com/svn/trunk@279 788f1e2b-df1e-0410-8736-df70ead52e1b
71 lines
2.5 KiB
Groff
71 lines
2.5 KiB
Groff
.TH MARKDOWN2PDF 1 "December 15, 2006" Pandoc "User Manuals"
|
|
.SH NAME
|
|
markdown2pdf \- converts markdown-formatted text to PDF, using pdflatex
|
|
.SH SYNOPSIS
|
|
\fBmarkdown2pdf\fR [\fIoptions\fR] [\fIinput-file\fR]...
|
|
.SH DESCRIPTION
|
|
\fBmarkdown2pdf\fR converts \fIinput\-file\fR (or text from standard
|
|
input) from markdown\-formatted plain text to PDF, using \fBpdflatex\fR.
|
|
If no output filename is specified, the name of the output file is
|
|
derived from the input file; thus, for example, if the input file
|
|
is \fIhello.txt\fR, the output file will be \fIhello.pdf\fR. If
|
|
the input is read from STDIN and no output filename is
|
|
specified, the output file will be named \fIstdin.pdf\fR. If
|
|
multiple input files are specified, they will be concatenated before
|
|
conversion, and the name of the output file will be derived from
|
|
the first input file.
|
|
.PP
|
|
Input is assumed to be in the UTF\-8 character encoding. If your
|
|
local character encoding is not UTF\-8, you should pipe input and
|
|
output through \fBiconv\fR:
|
|
.IP
|
|
.B iconv \-t utf\-8 input.txt | pandoc | iconv \-f utf\-8
|
|
.PP
|
|
\fBmarkdown2pdf\fR assumes that the 'unicode' package
|
|
is in latex's search path. If this package is not included in your
|
|
latex setup, it can be obtained from <http://ctan.org>.
|
|
.PP
|
|
\fBmarkdown2pdf\fR is a wrapper around \fBmarkdown2latex\fR.
|
|
.SH OPTIONS
|
|
.TP
|
|
.B \-o FILE, \-\-output=FILE
|
|
Write output to \fIFILE\fR.
|
|
.TP
|
|
.B \-p, \-\-preserve-tabs
|
|
Preserve tabs instead of converting them to spaces.
|
|
.TP
|
|
.B \-\-tab-stop=\fITABSTOP\fB
|
|
Specify tab stop (default is 4).
|
|
.TP
|
|
.B \-R, \-\-parse-raw
|
|
Parse untranslatable LaTeX environments as raw LaTeX,
|
|
instead of ignoring them.
|
|
.TP
|
|
.B \-N, \-\-number-sections
|
|
Number section headings in LaTeX output. (Default is not to number them.)
|
|
.TP
|
|
.B \-H \fIFILE\fB, \-\-include-in-header=\fIFILE\fB
|
|
Include (LaTeX) contents of \fIFILE\fR at the end of the header. Implies
|
|
\fB\-s\fR.
|
|
.TP
|
|
.B \-B \fIFILE\fB, \-\-include-before-body=\fIFILE\fB
|
|
Include (LaTeX) contents of \fIFILE\fR at the beginning of the document body.
|
|
.TP
|
|
.B \-A \fIFILE\fB, \-\-include-after-body=\fIFILE\fB
|
|
Include (LaTeX) contents of \fIFILE\fR at the end of the document body.
|
|
.TP
|
|
.B \-C \fIFILE\fB, \-\-custom-header=\fIFILE\fB
|
|
Use contents of \fIFILE\fR
|
|
as the LaTeX document header (overriding the default header, which can be
|
|
printed using '\fBpandoc \-D latex\fR'). Implies \fB-s\fR.
|
|
.TP
|
|
.B \-v, \-\-version
|
|
Print version.
|
|
.TP
|
|
.B \-h, \-\-help
|
|
Show usage message.
|
|
.SH "SEE ALSO"
|
|
\fBpandoc\fR(1),
|
|
\fBpdflatex\fR(1)
|
|
.SH AUTHOR
|
|
John MacFarlane and Recai Oktas
|