2006-12-22 21:16:03 +01:00
|
|
|
.TH MARKDOWN2PDF 1 "December 15, 2006" Pandoc "User Manuals"
|
2006-10-17 16:22:29 +02:00
|
|
|
.SH NAME
|
|
|
|
|
markdown2pdf \- converts markdown-formatted text to PDF, using pdflatex
|
|
|
|
|
.SH SYNOPSIS
|
2006-12-22 21:16:03 +01:00
|
|
|
\fBmarkdown2pdf\fR [\fIoptions\fR] [\fIinput-file\fR]...
|
2006-11-01 07:32:52 +01:00
|
|
|
.SH DESCRIPTION
|
2006-12-22 21:16:03 +01:00
|
|
|
\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.
|
2006-11-14 08:06:14 +01:00
|
|
|
.PP
|
2006-12-22 21:16:03 +01:00
|
|
|
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.
|
2006-11-14 08:06:14 +01:00
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
2006-12-22 21:16:03 +01:00
|
|
|
.B \-o FILE, \-\-output=FILE
|
|
|
|
|
Write output to \fIFILE\fR.
|
2006-11-14 08:06:14 +01:00
|
|
|
.TP
|
2006-12-22 21:16:03 +01:00
|
|
|
.B \-p, \-\-preserve-tabs
|
|
|
|
|
Preserve tabs instead of converting them to spaces.
|
2006-12-12 08:04:09 +01:00
|
|
|
.TP
|
2006-12-22 21:16:03 +01:00
|
|
|
.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.
|
2006-11-03 08:08:47 +01:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
|
\fBpandoc\fR(1),
|
|
|
|
|
\fBpdflatex\fR(1)
|
2006-10-17 16:22:29 +02:00
|
|
|
.SH AUTHOR
|
2006-12-12 08:04:09 +01:00
|
|
|
John MacFarlane and Recai Oktas
|
