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
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
|
.TH MARKDOWN2PDF 1 "January 29, 2011" "Pandoc User Manuals"
.SH NAME
.PP
markdown2pdf - converts markdown-formatted text to PDF, using pdflatex
.SH SYNOPSIS
.PP
markdown2pdf [\f[I]options\f[]] [\f[I]input-file\f[]]...
.SH DESCRIPTION
.PP
\f[C]markdown2pdf\f[] converts \f[I]input-file\f[] (or text from
standard input) from markdown-formatted plain text to PDF, using
\f[C]pandoc\f[] and \f[C]pdflatex\f[].
If no output filename is specified (using the \f[C]-o\f[] option), the
name of the output file is derived from the input file; thus, for
example, if the input file is \f[I]hello.txt\f[], the output file will
be \f[I]hello.pdf\f[].
If the input is read from STDIN and no output filename is specified, the
output file will be named \f[I]stdin.pdf\f[].
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
through \f[C]iconv\f[]:
.IP
.nf
\f[C]
iconv\ -t\ utf-8\ input.txt\ |\ markdown2pdf
\f[]
.fi
.PP
\f[C]markdown2pdf\f[] assumes that the \f[C]unicode\f[], \f[C]array\f[],
\f[C]fancyvrb\f[], \f[C]graphicx\f[], and \f[C]ulem\f[] packages are in
latex\[aq]s search path.
If these packages are not included in your latex setup, they can be
obtained from \f[C]http://ctan.org\f[].
.SH OPTIONS
.TP
.B -o \f[I]FILE\f[], --output=\f[I]FILE\f[]
Write output to \f[I]FILE\f[].
.RS
.RE
.TP
.B --strict
Use strict markdown syntax, with no extensions or variants.
.RS
.RE
.TP
.B -N, --number-sections
Number section headings in LaTeX output.
(Default is not to number them.)
.RS
.RE
.TP
.B --listings
Use listings package for LaTeX code blocks
.RS
.RE
.TP
.B --template=\f[I]FILE\f[]
Use \f[I]FILE\f[] as a custom template for the generated document.
Implies \f[C]-s\f[].
See the section TEMPLATES in \f[C]pandoc\f[](1) for information about
template syntax.
Use \f[C]pandoc\ -D\ latex\f[] to print the default LaTeX template.
.RS
.RE
.TP
.B -V KEY=VAL, --variable=\f[I]KEY:VAL\f[]
Set the template variable KEY to the value VAL when rendering the
document in standalone mode.
Use this to set the font size when using the default LaTeX template:
\f[C]-V\ fontsize=12pt\f[].
.RS
.RE
.TP
.B -H \f[I]FILE\f[], --include-in-header=\f[I]FILE\f[]
Include (LaTeX) contents of \f[I]FILE\f[] at the end of the header.
Implies \f[C]-s\f[].
.RS
.RE
.TP
.B -B \f[I]FILE\f[], --include-before-body=\f[I]FILE\f[]
Include (LaTeX) contents of \f[I]FILE\f[] at the beginning of the
document body.
.RS
.RE
.TP
.B -A \f[I]FILE\f[], --include-after-body=\f[I]FILE\f[]
Include (LaTeX) contents of \f[I]FILE\f[] at the end of the document
body.
.RS
.RE
.TP
.B --bibliography=\f[I]FILE\f[]
Specify bibliography database to be used in resolving citations.
The database type will be determined from the extension of
\f[I]FILE\f[], which may be \f[C].xml\f[] (MODS format), \f[C].bib\f[]
(BibTeX format), or \f[C].json\f[] (citeproc JSON).
.RS
.RE
.TP
.B --csl=\f[I]FILE\f[]
Specify CSL style to be used in formatting citations and the
bibliography.
If \f[I]FILE\f[] is not found, pandoc will look for it in
.RS
.IP
.nf
\f[C]
$HOME/.csl
\f[]
.fi
.PP
in unix and
.IP
.nf
\f[C]
C:\\Documents\ And\ Settings\\USERNAME\\Application\ Data\\csl
\f[]
.fi
.PP
in Windows.
If the \f[C]--csl\f[] option is not specified, pandoc will use a default
style: either \f[C]default.csl\f[] in the user data directory (see
\f[C]--data-dir\f[]), or, if that is not present, the Chicago
author-date style.
.RE
.TP
.B --data-dir\f[I]=DIRECTORY\f[]
Specify the user data directory to search for pandoc data files.
If this option is not specified, the default user data directory will be
used:
.RS
.IP
.nf
\f[C]
$HOME/.pandoc
\f[]
.fi
.PP
in unix and
.IP
.nf
\f[C]
C:\\Documents\ And\ Settings\\USERNAME\\Application\ Data\\pandoc
\f[]
.fi
.PP
in Windows.
A \f[C]reference.odt\f[], \f[C]epub.css\f[], \f[C]templates\f[]
directory, or \f[C]s5\f[] directory placed in this directory will
override pandoc\[aq]s normal defaults.
.RE
.TP
.B --xetex
Use xelatex instead of pdflatex to create the PDF.
.RS
.RE
.TP
.B --luatex
Use lualatex instead of pdflatex to create the PDF.
.RS
.RE
.SH SEE ALSO
.PP
\f[C]pandoc\f[](1), \f[C]pdflatex\f[](1)
.SH AUTHORS
John MacFarlane, Paulo Tanimoto, and Recai Oktas.
|
