@@ -1,5 +1,5 @@
11.\"t
2−.TH PANDOC 1 "July 15, 2015" ""
2+.TH PANDOC 1 "November 12, 2015" "pandoc 1.15.2"
33.SH NAME
44pandoc - general markup converter
55.SH SYNOPSIS
@@ -20,33 +20,34 @@ Texinfo, MediaWiki markup, DokuWiki markup, Haddock markup, EPUB (v2 or
2020v3), FictionBook2, Textile, groff man pages, Emacs Org mode, AsciiDoc,
2121InDesign ICML, and Slidy, Slideous, DZSlides, reveal.js or S5 HTML slide
2222shows.
23−It can also produce PDF output on systems where LaTeX is installed.
23+It can also produce PDF output on systems where LaTeX or ConTeXt is
24+installed.
2425.PP
25−Pandoc\[aq]s enhanced version of markdown includes syntax for footnotes,
26+Pandoc\[aq]s enhanced version of Markdown includes syntax for footnotes,
2627tables, flexible ordered lists, definition lists, fenced code blocks,
2728superscripts and subscripts, strikeout, metadata blocks, automatic
28−tables of contents, embedded LaTeX math, citations, and markdown inside
29+tables of contents, embedded LaTeX math, citations, and Markdown inside
2930HTML block elements.
30−(These enhancements, described below under Pandoc\[aq]s markdown, can be
31+(These enhancements, described below under Pandoc\[aq]s Markdown, can be
3132disabled using the \f[C]markdown_strict\f[] input or output format.)
3233.PP
33−In contrast to most existing tools for converting markdown to HTML,
34−which use regex substitutions, Pandoc has a modular design: it consists
34+In contrast to most existing tools for converting Markdown to HTML,
35+which use regex substitutions, pandoc has a modular design: it consists
3536of a set of readers, which parse text in a given format and produce a
3637native representation of the document, and a set of writers, which
3738convert this native representation into a target format.
3839Thus, adding an input or output format requires only adding a reader or
3940writer.
4041.PP
41−Because Pandoc\[aq]s intermediate representation of a document is less
42+Because pandoc\[aq]s intermediate representation of a document is less
4243expressive than many of the formats it converts between, one should not
4344expect perfect conversions between every format and every other.
4445Pandoc attempts to preserve the structural elements of a document, but
4546not formatting details such as margin size.
4647And some document elements, such as complex tables, may not fit into
47−Pandoc\[aq]s simple document model.
48−While conversions from Pandoc\[aq]s Markdown to all formats aspire to be
49−perfect, conversions from formats more expressive than Pandoc\[aq]s
48+pandoc\[aq]s simple document model.
49+While conversions from pandoc\[aq]s Markdown to all formats aspire to be
50+perfect, conversions from formats more expressive than pandoc\[aq]s
5051Markdown can be expected to be lossy.
5152.SS Using \f[C]pandoc\f[]
5253.PP
@@ -98,7 +99,7 @@ command\-line options.
9899The input format can be specified using the \f[C]\-r/\-\-read\f[] or
99100\f[C]\-f/\-\-from\f[] options, the output format using the
100101\f[C]\-w/\-\-write\f[] or \f[C]\-t/\-\-to\f[] options.
101−Thus, to convert \f[C]hello.txt\f[] from markdown to LaTeX, you could
102+Thus, to convert \f[C]hello.txt\f[] from Markdown to LaTeX, you could
102103type:
103104.IP
104105.nf
@@ -107,7 +108,7 @@ pandoc\ \-f\ markdown\ \-t\ latex\ hello.txt
107108\f[]
108109.fi
109110.PP
110−To convert \f[C]hello.html\f[] from HTML to markdown:
111+To convert \f[C]hello.html\f[] from HTML to Markdown:
111112.IP
112113.nf
113114\f[C]
@@ -134,13 +135,13 @@ pandoc\ \-o\ hello.tex\ hello.txt
134135\f[]
135136.fi
136137.PP
137−will convert \f[C]hello.txt\f[] from markdown to LaTeX.
138+will convert \f[C]hello.txt\f[] from Markdown to LaTeX.
138139If no output file is specified (so that output goes to \f[I]stdout\f[]),
139140or if the output file\[aq]s extension is unknown, the output format will
140141default to HTML.
141142If no input file is specified (so that input comes from \f[I]stdin\f[]),
142143or if the input files\[aq] extensions are unknown, the input format will
143−be assumed to be markdown unless explicitly specified.
144+be assumed to be Markdown unless explicitly specified.
144145.PP
145146Pandoc uses the UTF\-8 character encoding for both input and output.
146147If your local character encoding is not UTF\-8, you should pipe input
@@ -160,7 +161,7 @@ the \f[C]\-s/\-\-standalone\f[] option.
160161.PP
161162To produce a PDF, specify an output file with a \f[C]\&.pdf\f[]
162163extension.
163−Pandoc will use LaTeX to convert it to PDF:
164+By default, pandoc will use LaTeX to convert it to PDF:
164165.IP
165166.nf
166167\f[C]
@@ -190,7 +191,12 @@ The \f[C]natbib\f[], \f[C]biblatex\f[], \f[C]bibtex\f[], and
190191\f[C]biber\f[] packages can optionally be used for citation rendering.
191192These are included with all recent versions of TeX Live.
192193.PP
193−PDF output can be controlled using variables for LaTeX.
194+Alternatively, pandoc can use ConTeXt to create a PDF.
195+To do this, specify an output file with a \f[C]\&.pdf\f[] extension, as
196+before, but add \f[C]\-t\ context\f[] to the command line.
197+.PP
198+PDF output can be controlled using variables for LaTeX or variables for
199+ConTeXt.
194200.SS \f[C]hsmarkdown\f[]
195201.PP
196202A user who wants a drop\-in replacement for \f[C]Markdown.pl\f[] may
@@ -209,10 +215,10 @@ simulation of symbolic links.
209215Specify input format.
210216\f[I]FORMAT\f[] can be \f[C]native\f[] (native Haskell), \f[C]json\f[]
211217(JSON version of native AST), \f[C]markdown\f[] (pandoc\[aq]s extended
212−markdown), \f[C]markdown_strict\f[] (original unextended markdown),
218+Markdown), \f[C]markdown_strict\f[] (original unextended Markdown),
213219\f[C]markdown_phpextra\f[] (PHP Markdown Extra),
214220\f[C]markdown_github\f[] (GitHub\-Flavored Markdown),
215−\f[C]commonmark\f[] (CommonMark markdown), \f[C]textile\f[] (Textile),
221+\f[C]commonmark\f[] (CommonMark Markdown), \f[C]textile\f[] (Textile),
216222\f[C]rst\f[] (reStructuredText), \f[C]html\f[] (HTML), \f[C]docbook\f[]
217223(DocBook), \f[C]t2t\f[] (txt2tags), \f[C]docx\f[] (docx), \f[C]odt\f[]
218224(ODT), \f[C]epub\f[] (EPUB), \f[C]opml\f[] (OPML), \f[C]org\f[] (Emacs
@@ -225,10 +231,10 @@ Markdown syntax extensions can be individually enabled or disabled by
225231appending \f[C]+EXTENSION\f[] or \f[C]\-EXTENSION\f[] to the format
226232name.
227233So, for example, \f[C]markdown_strict+footnotes+definition_lists\f[] is
228−strict markdown with footnotes and definition lists enabled, and
229−\f[C]markdown\-pipe_tables+hard_line_breaks\f[] is pandoc\[aq]s markdown
234+strict Markdown with footnotes and definition lists enabled, and
235+\f[C]markdown\-pipe_tables+hard_line_breaks\f[] is pandoc\[aq]s Markdown
230236without pipe tables and with hard line breaks.
231−See Pandoc\[aq]s markdown, below, for a list of extensions and their
237+See Pandoc\[aq]s Markdown, below, for a list of extensions and their
232238names.
233239.RS
234240.RE
@@ -237,11 +243,11 @@ names.
237243Specify output format.
238244\f[I]FORMAT\f[] can be \f[C]native\f[] (native Haskell), \f[C]json\f[]
239245(JSON version of native AST), \f[C]plain\f[] (plain text),
240−\f[C]markdown\f[] (pandoc\[aq]s extended markdown),
241−\f[C]markdown_strict\f[] (original unextended markdown),
246+\f[C]markdown\f[] (pandoc\[aq]s extended Markdown),
247+\f[C]markdown_strict\f[] (original unextended Markdown),
242248\f[C]markdown_phpextra\f[] (PHP Markdown Extra),
243249\f[C]markdown_github\f[] (GitHub\-Flavored Markdown),
244−\f[C]commonmark\f[] (CommonMark markdown), \f[C]rst\f[]
250+\f[C]commonmark\f[] (CommonMark Markdown), \f[C]rst\f[]
245251(reStructuredText), \f[C]html\f[] (XHTML), \f[C]html5\f[] (HTML5),
246252\f[C]latex\f[] (LaTeX), \f[C]beamer\f[] (LaTeX beamer slide show),
247253\f[C]context\f[] (ConTeXt), \f[C]man\f[] (groff man), \f[C]mediawiki\f[]
@@ -350,9 +356,9 @@ Show usage message.
350356Parse untranslatable HTML codes and LaTeX environments as raw HTML or
351357LaTeX, instead of ignoring them.
352358Affects only HTML and LaTeX input.
353−Raw HTML can be printed in markdown, reStructuredText, HTML, Slidy,
359+Raw HTML can be printed in Markdown, reStructuredText, HTML, Slidy,
354360Slideous, DZSlides, reveal.js, and S5 output; raw LaTeX can be printed
355−in markdown, reStructuredText, LaTeX, and ConTeXt output.
361+in Markdown, reStructuredText, LaTeX, and ConTeXt output.
356362The default is for the readers to omit untranslatable HTML codes and
357363LaTeX environments.
358364(The LaTeX reader does pass through untranslatable LaTeX
@@ -365,11 +371,8 @@ Produce typographically correct output, converting straight quotes to
365371curly quotes, \f[C]\-\-\-\f[] to em\-dashes, \f[C]\-\-\f[] to
366372en\-dashes, and \f[C]\&...\f[] to ellipses.
367373Nonbreaking spaces are inserted after certain abbreviations, such as
368−"Mr." (Note: This option is significant only when the input format is
369−\f[C]markdown\f[], \f[C]markdown_strict\f[], \f[C]textile\f[] or
370−\f[C]twiki\f[].
371−It is selected automatically when the input format is \f[C]textile\f[]
372−or the output format is \f[C]latex\f[] or \f[C]context\f[], unless
374+"Mr." (Note: This option is selected automatically when the output
375+format is \f[C]latex\f[] or \f[C]context\f[], unless
373376\f[C]\-\-no\-tex\-ligatures\f[] is used.)
374377.RS
375378.RE
@@ -399,12 +402,12 @@ Specify a default extension to use when image paths/URLs have no
399402extension.
400403This allows you to use the same source for formats that require
401404different kinds of images.
402−Currently this option only affects the markdown and LaTeX readers.
405+Currently this option only affects the Markdown and LaTeX readers.
403406.RS
404407.RE
405408.TP
406409.B \f[C]\-\-filter=\f[]\f[I]EXECUTABLE\f[]
407−Specify an executable to be used as a filter transforming the Pandoc AST
410+Specify an executable to be used as a filter transforming the pandoc AST
408411after the input is parsed and before the output is written.
409412The executable should read JSON from stdin and write JSON to stdout.
410413The JSON must be formatted like pandoc\[aq]s own JSON input and output.
@@ -674,13 +677,13 @@ instead of UTF\-8 when this option is selected).
674677.TP
675678.B \f[C]\-\-reference\-links\f[]
676679Use reference\-style links, rather than inline links, in writing
677−markdown or reStructuredText.
680+Markdown or reStructuredText.
678681By default inline links are used.
679682.RS
680683.RE
681684.TP
682685.B \f[C]\-\-atx\-headers\f[]
683−Use ATX\-style headers in markdown and asciidoc output.
686+Use ATX\-style headers in Markdown and asciidoc output.
684687The default is to use setext\-style headers for levels 1\-2, and then
685688ATX headers.
686689.RS
@@ -776,7 +779,7 @@ or hexadecimal character references.
776779.TP
777780.B \f[C]\-\-id\-prefix=\f[]\f[I]STRING\f[]
778781Specify a prefix to be added to all automatically generated identifiers
779−in HTML and DocBook output, and to footnote numbers in markdown output.
782+in HTML and DocBook output, and to footnote numbers in Markdown output.
780783This is useful for preventing duplicate identifiers when generating
781784fragments to be included in other pages.
782785.RS
@@ -844,7 +847,7 @@ If it is not found there, sensible defaults will be used.
844847Use the specified image as the EPUB cover.
845848It is recommended that the image be less than 1000px in width and
846849height.
847−Note that in a markdown source document you can also specify
850+Note that in a Markdown source document you can also specify
848851\f[C]cover\-image\f[] in a YAML metadata block (see EPUB Metadata,
849852below).
850853.RS
@@ -871,7 +874,7 @@ which should be in ISO 8601 format), \f[C]<dc:language>\f[] (from the
871874\f[C]<dc:identifier\ id="BookId">\f[] (a randomly generated UUID).
872875Any of these may be overridden by elements in the metadata file.
873876.PP
874−Note: if the source document is markdown, a YAML metadata block in the
877+Note: if the source document is Markdown, a YAML metadata block in the
875878document can be used instead.
876879See below under EPUB Metadata.
877880.RE
@@ -1086,7 +1089,7 @@ with the \f[C]\-o\f[] option, or \f[C]\-\f[] (for \f[I]stdout\f[]) if no
10861089output file was specified.
10871090The remaining lines contain the command\-line arguments, one per line,
10881091in the order they appear.
1089−These do not include regular Pandoc options and their arguments, but do
1092+These do not include regular pandoc options and their arguments, but do
10901093include any options appearing after a \f[C]\-\-\f[] separator at the end
10911094of the line.
10921095.RS
@@ -1094,7 +1097,7 @@ of the line.
10941097.TP
10951098.B \f[C]\-\-ignore\-args\f[]
10961099Ignore command\-line arguments (for use in wrapper scripts).
1097−Regular Pandoc options are not ignored.
1100+Regular pandoc options are not ignored.
10981101Thus, for example,
10991102.RS
11001103.IP
@@ -1150,7 +1153,7 @@ fields as well as the following:
11501153.TP
11511154.B \f[C]title\f[], \f[C]author\f[], \f[C]date\f[]
11521155allow identification of basic aspects of the document.
1153−Included in PDF metadata through LaTeX.
1156+Included in PDF metadata through LaTeX and ConTeXt.
11541157These can be set through a pandoc title block, which allows for multiple
11551158authors, or through a YAML metadata block:
11561159.RS
@@ -1166,8 +1169,19 @@ author:
11661169.fi
11671170.RE
11681171.TP
1172+.B \f[C]subtitle\f[]
1173+document subtitle; also used as subject in PDF metadata
1174+.RS
1175+.RE
1176+.TP
11691177.B \f[C]abstract\f[]
1170−allows for specification of document summary in LaTeX and Word docx
1178+document summary, included in LaTeX, ConTeXt, AsciiDoc, and Word docx
1179+.RS
1180+.RE
1181+.TP
1182+.B \f[C]keywords\f[]
1183+list of keywords to be included in HTML, PDF, and AsciiDoc metadata; may
1184+be repeated as for \f[C]author\f[], above
11711185.RS
11721186.RE
11731187.TP
@@ -1183,6 +1197,11 @@ specified
11831197.RS
11841198.RE
11851199.TP
1200+.B \f[C]toc\-title\f[]
1201+title of table of contents (works only with EPUB and docx)
1202+.RS
1203+.RE
1204+.TP
11861205.B \f[C]include\-before\f[]
11871206contents specified by \f[C]\-B/\-\-include\-before\-body\f[] (may have
11881207multiple values)
@@ -1209,14 +1228,23 @@ For some output formats, pandoc will convert it to an appropriate format
12091228stored in the additional variables \f[C]babel\-lang\f[],
12101229\f[C]polyglossia\-lang\f[] (LaTeX) and \f[C]context\-lang\f[] (ConTeXt).
12111230.RS
1231+.PP
1232+Native pandoc \f[C]span\f[]s and \f[C]div\f[]s with the lang attribute
1233+(value in BCP 47) can be used to switch the language in that range.
12121234.RE
12131235.TP
12141236.B \f[C]otherlangs\f[]
12151237a list of other languages used in the document in the YAML metadata,
12161238according to BCP 47.
12171239For example: \f[C]otherlangs:\ [en\-GB,\ fr]\f[].
1218−Currently only used by \f[C]xelatex\f[] through the generated
1219−\f[C]polyglossia\-otherlangs\f[] variable.
1240+This is automatically generated from the \f[C]lang\f[] attributes in all
1241+\f[C]span\f[]s and \f[C]div\f[]s but can be overriden.
1242+Currently only used by LaTeX through the generated
1243+\f[C]babel\-otherlangs\f[] and \f[C]polyglossia\-otherlangs\f[]
1244+variables.
1245+The LaTeX writer outputs polyglossia commands in the text but the
1246+\f[C]babel\-newcommands\f[] variable contains mappings for them to the
1247+corresponding babel.
12201248.RS
12211249.RE
12221250.TP
@@ -1233,11 +1261,6 @@ This may not always be necessary if the final renderer (e.g.
12331261the browser, when generating HTML) supports the Unicode Bidirectional
12341262Algorithm.
12351263.PP
1236−LaTeX and ConTeXt assume by default that all text is left\-to\-right.
1237−Setting \f[C]dir:\ ltr\f[] enables bidirectional text handling in a
1238−document whose base direction is left\-to\-right but contains some
1239−right\-to\-left script.
1240−.PP
12411264When using LaTeX for bidirectional documents, only the \f[C]xelatex\f[]
12421265engine is fully supported (use \f[C]\-\-latex\-engine=xelatex\f[]).
12431266.RE
@@ -1276,39 +1299,38 @@ themes for LaTeX \f[C]beamer\f[] documents
12761299LaTeX variables are used when creating a PDF.
12771300.TP
12781301.B \f[C]fontsize\f[]
1279−font size (e.g.
1280−\f[C]10pt\f[], \f[C]12pt\f[]) for LaTeX documents
1302+font size for body text (e.g.
1303+\f[C]10pt\f[], \f[C]12pt\f[])
12811304.RS
12821305.RE
12831306.TP
12841307.B \f[C]documentclass\f[]
1285−document class for LaTeX documents, e.g.
1308+document class, e.g.
12861309\f[C]article\f[], \f[C]report\f[], \f[C]book\f[], \f[C]memoir\f[]
12871310.RS
12881311.RE
12891312.TP
12901313.B \f[C]classoption\f[]
1291−option for LaTeX document class, e.g.
1314+option for document class, e.g.
12921315\f[C]oneside\f[]; may be repeated for multiple options
12931316.RS
12941317.RE
12951318.TP
12961319.B \f[C]geometry\f[]
1297−option for LaTeX \f[C]geometry\f[] package, e.g.
1320+option for \f[C]geometry\f[] package, e.g.
12981321\f[C]margin=1in\f[]; may be repeated for multiple options
12991322.RS
13001323.RE
13011324.TP
13021325.B \f[C]linestretch\f[]
1303−adjusts line spacing in LaTeX documents using the \f[C]setspace\f[]
1304−package, e.g.
1326+adjusts line spacing using the \f[C]setspace\f[] package, e.g.
13051327\f[C]1.25\f[], \f[C]1.5\f[]
13061328.RS
13071329.RE
13081330.TP
13091331.B \f[C]fontfamily\f[]
1310−font package for LaTeX documents (with \f[C]pdflatex\f[]): TeX Live
1311−includes many options, documented in the LaTeX Font Catalogue.
1332+font package for use with \f[C]pdflatex\f[]: TeX Live includes many
1333+options, documented in the LaTeX Font Catalogue.
13121334The default is Latin Modern.
13131335.RS
13141336.RE
@@ -1316,14 +1338,14 @@ The default is Latin Modern.
13161338.B \f[C]fontfamilyoptions\f[]
13171339options for package used as \f[C]fontfamily\f[]: e.g.
13181340\f[C]osf,sc\f[] with \f[C]fontfamily\f[] set to \f[C]mathpazo\f[]
1319−provides Palatino with old\-style figures and true small caps
1341+provides Palatino with old\-style figures and true small caps; may be
1342+repeated for multiple options
13201343.RS
13211344.RE
13221345.TP
13231346.B \f[C]mainfont\f[], \f[C]sansfont\f[], \f[C]monofont\f[], \f[C]mathfont\f[], \f[C]CJKmainfont\f[]
1324−fonts for LaTeX documents (works only with \f[C]xelatex\f[] and
1325−\f[C]lualatex\f[]): takes the name of any system font, using the
1326−\f[C]fontspec\f[] package.
1347+font families for use with \f[C]xelatex\f[] or \f[C]lualatex\f[]: take
1348+the name of any system font, using the \f[C]fontspec\f[] package.
13271349Note that if \f[C]CJKmainfont\f[] is used, the \f[C]xecjk\f[] package
13281350must be available.
13291351.RS
@@ -1333,8 +1355,9 @@ must be available.
13331355options to use with \f[C]mainfont\f[], \f[C]sansfont\f[],
13341356\f[C]monofont\f[], \f[C]mathfont\f[], \f[C]CJKmainfont\f[] in
13351357\f[C]xelatex\f[] and \f[C]lualatex\f[].
1336−Allows for any choices available through \f[C]fontspec\f[], such as the
1358+Allow for any choices available through \f[C]fontspec\f[], such as the
13371359OpenType features \f[C]Numbers=OldStyle,Numbers=Proportional\f[].
1360+May be repeated for multiple options.
13381361.RS
13391362.RE
13401363.TP
@@ -1347,8 +1370,8 @@ font encodings)
13471370.TP
13481371.B \f[C]linkcolor\f[], \f[C]toccolor\f[], \f[C]urlcolor\f[], \f[C]citecolor\f[]
13491372color for internal links, links in table of contents, external links,
1350−and citation links in LaTeX documents, using options available through
1351−\f[C]color\f[] package, e.g.
1373+and citation links, using options available through \f[C]color\f[]
1374+package, e.g.
13521375\f[C]red\f[], \f[C]green\f[], \f[C]magenta\f[], \f[C]cyan\f[],
13531376\f[C]blue\f[], \f[C]black\f[]
13541377.RS
@@ -1361,7 +1384,7 @@ color
13611384.RE
13621385.TP
13631386.B \f[C]links\-as\-notes\f[]
1364−causes links to be printed as footnotes in LaTeX documents
1387+causes links to be printed as footnotes
13651388.RS
13661389.RE
13671390.TP
@@ -1379,37 +1402,103 @@ in some classes
13791402.RE
13801403.TP
13811404.B \f[C]toc\f[]
1382−include table of contents in LaTeX documents
1405+include table of contents (can also be set using
1406+\f[C]\-\-toc/\-\-table\-of\-contents\f[])
13831407.RS
13841408.RE
13851409.TP
13861410.B \f[C]toc\-depth\f[]
1387−level of section to include in table of contents in LaTeX documents
1411+level of section to include in table of contents
13881412.RS
13891413.RE
13901414.TP
1391−.B \f[C]toc\-title\f[]
1392−title of table of contents (works only with EPUB and docx)
1415+.B \f[C]lof\f[], \f[C]lot\f[]
1416+include list of figures, list of tables
13931417.RS
13941418.RE
13951419.TP
1396−.B \f[C]lof\f[]
1397−include list of figures in LaTeX documents
1420+.B \f[C]bibliography\f[]
1421+bibliography to use for resolving references
13981422.RS
13991423.RE
14001424.TP
1401−.B \f[C]lot\f[]
1402−include list of tables in LaTeX documents
1425+.B \f[C]biblio\-style\f[]
1426+bibliography style, when used with \f[C]\-\-natbib\f[]
14031427.RS
14041428.RE
1429+.SS Variables for ConTeXt
14051430.TP
1406−.B \f[C]bibliography\f[]
1407−bibliography to use for resolving references
1431+.B \f[C]papersize\f[]
1432+paper size, e.g.
1433+\f[C]letter\f[], \f[C]A4\f[], \f[C]landscape\f[] (see ConTeXt Paper
1434+Setup); may be repeated for multiple options
14081435.RS
14091436.RE
14101437.TP
1411−.B \f[C]biblio\-style\f[]
1412−bibliography style in LaTeX, when used with \f[C]\-\-natbib\f[]
1438+.B \f[C]layout\f[]
1439+options for page margins and text arrangement (see ConTeXt Layout); may
1440+be repeated for multiple options
1441+.RS
1442+.RE
1443+.TP
1444+.B \f[C]fontsize\f[]
1445+font size for body text (e.g.
1446+\f[C]10pt\f[], \f[C]12pt\f[])
1447+.RS
1448+.RE
1449+.TP
1450+.B \f[C]mainfont\f[], \f[C]sansfont\f[], \f[C]monofont\f[], \f[C]mathfont\f[]
1451+font families: take the name of any system font (see ConTeXt Font
1452+Switching)
1453+.RS
1454+.RE
1455+.TP
1456+.B \f[C]linkcolor\f[]
1457+color for links, e.g.
1458+\f[C]red\f[], \f[C]blue\f[] (see ConTeXt Color)
1459+.RS
1460+.RE
1461+.TP
1462+.B \f[C]indenting\f[]
1463+controls indentation of paragraphs, e.g.
1464+\f[C]yes,small,next\f[] (see ConTeXt Indentation); may be repeated for
1465+multiple options
1466+.RS
1467+.RE
1468+.TP
1469+.B \f[C]whitespace\f[]
1470+spacing between paragraphs, e.g.
1471+\f[C]none\f[], \f[C]small\f[] (using \f[C]setupwhitespace\f[])
1472+.RS
1473+.RE
1474+.TP
1475+.B \f[C]interlinespace\f[]
1476+adjusts line spacing, e.g.
1477+\f[C]4ex\f[] (using \f[C]setupinterlinespace\f[]); may be repeated for
1478+multiple options
1479+.RS
1480+.RE
1481+.TP
1482+.B \f[C]headertext\f[], \f[C]footertext\f[]
1483+text to be placed in running header or footer (see ConTeXt Headers and
1484+Footers); may be repeated up to four times for different placement
1485+.RS
1486+.RE
1487+.TP
1488+.B \f[C]pagenumbering\f[]
1489+page number style and location (using \f[C]setuppagenumbering\f[]); may
1490+be repeated for multiple options
1491+.RS
1492+.RE
1493+.TP
1494+.B \f[C]toc\f[]
1495+include table of contents (can also be set using
1496+\f[C]\-\-toc/\-\-table\-of\-contents\f[])
1497+.RS
1498+.RE
1499+.TP
1500+.B \f[C]lof\f[], \f[C]lot\f[]
1501+include list of figures, list of tables
14131502.RS
14141503.RE
14151504.SS Variables for man pages
@@ -1515,16 +1604,16 @@ merge in changes after each pandoc release.
15151604.SH PANDOC\[aq]S MARKDOWN
15161605.PP
15171606Pandoc understands an extended and slightly revised version of John
1518−Gruber\[aq]s markdown syntax.
1607+Gruber\[aq]s Markdown syntax.
15191608This document explains the syntax, noting differences from standard
1520−markdown.
1609+Markdown.
15211610Except where noted, these differences can be suppressed by using the
15221611\f[C]markdown_strict\f[] format instead of \f[C]markdown\f[].
15231612An extensions can be enabled by adding \f[C]+EXTENSION\f[] to the format
15241613name and disabled by adding \f[C]\-EXTENSION\f[].
1525−For example, \f[C]markdown_strict+footnotes\f[] is strict markdown with
1614+For example, \f[C]markdown_strict+footnotes\f[] is strict Markdown with
15261615footnotes enabled, while \f[C]markdown\-footnotes\-pipe_tables\f[] is
1527−pandoc\[aq]s markdown without footnotes or pipe tables.
1616+pandoc\[aq]s Markdown without footnotes or pipe tables.
15281617.SS Philosophy
15291618.PP
15301619Markdown is designed to be easy to write, and, even more importantly,
@@ -1541,8 +1630,8 @@ This principle has guided pandoc\[aq]s decisions in finding syntax for
15411630tables, footnotes, and other extensions.
15421631.PP
15431632There is, however, one respect in which pandoc\[aq]s aims are different
1544−from the original aims of markdown.
1545−Whereas markdown was originally designed with HTML generation in mind,
1633+from the original aims of Markdown.
1634+Whereas Markdown was originally designed with HTML generation in mind,
15461635pandoc is designed for multiple output formats.
15471636Thus, while pandoc allows the embedding of raw HTML, it discourages it,
15481637and provides other, non\-HTMLish ways of representing important document
@@ -1605,7 +1694,7 @@ As with setext\-style headers, the header text can contain formatting:
16051694.fi
16061695.SS Extension: \f[C]blank_before_header\f[]
16071696.PP
1608−Standard markdown syntax does not require a blank line before a header.
1697+Standard Markdown syntax does not require a blank line before a header.
16091698Pandoc does require this (except, of course, at the beginning of the
16101699document).
16111700The reason for the requirement is that it is all too easy for a
@@ -1707,28 +1796,27 @@ Identifier
17071796T}
17081797_
17091798T{
1710−Header identifiers in HTML
1799+\f[C]Header\ identifiers\ in\ HTML\f[]
17111800T}@T{
17121801\f[C]header\-identifiers\-in\-html\f[]
17131802T}
17141803T{
1715−\f[I]Dogs\f[]?\-\-in \f[I]my\f[] house?
1804+\f[C]*Dogs*?\-\-in\ *my*\ house?\f[]
17161805T}@T{
17171806\f[C]dogs\-\-in\-my\-house\f[]
17181807T}
17191808T{
1720−HTML, S5, or RTF?
1809+\f[C][HTML],\ [S5],\ or\ [RTF]?\f[]
17211810T}@T{
17221811\f[C]html\-s5\-or\-rtf\f[]
17231812T}
17241813T{
1725−3.
1726−Applications
1814+\f[C]3.\ Applications\f[]
17271815T}@T{
17281816\f[C]applications\f[]
17291817T}
17301818T{
1731−33
1819+\f[C]33\f[]
17321820T}@T{
17331821\f[C]section\f[]
17341822T}
@@ -1877,7 +1965,7 @@ spaces after the \f[C]>\f[]:
18771965.fi
18781966.SS Extension: \f[C]blank_before_blockquote\f[]
18791967.PP
1880−Standard markdown syntax does not require a blank line before a block
1968+Standard Markdown syntax does not require a blank line before a block
18811969quote.
18821970Pandoc does require this (except, of course, at the beginning of the
18831971document).
@@ -1916,7 +2004,7 @@ Note: blank lines in the verbatim text need not begin with four spaces.
19162004.SS Fenced code blocks
19172005.SS Extension: \f[C]fenced_code_blocks\f[]
19182006.PP
1919−In addition to standard indented code blocks, Pandoc supports
2007+In addition to standard indented code blocks, pandoc supports
19202008\f[I]fenced\f[] code blocks.
19212009These begin with a row of three or more tildes (\f[C]~\f[]) and end with
19222010a row of tildes that must be at least as long as the starting row.
@@ -2022,7 +2110,7 @@ For more information on highlighting, see Syntax highlighting, below.
20222110A line block is a sequence of lines beginning with a vertical bar
20232111(\f[C]|\f[]) followed by a space.
20242112The division into lines will be preserved in the output, as will any
2025−leading spaces; otherwise, the lines will be formatted as markdown.
2113+leading spaces; otherwise, the lines will be formatted as Markdown.
20262114This is useful for verse and addresses:
20272115.IP
20282116.nf
@@ -2096,7 +2184,7 @@ List items look best if subsequent lines are flush with the first line
20962184\f[]
20972185.fi
20982186.PP
2099−But markdown also allows a "lazy" format:
2187+But Markdown also allows a "lazy" format:
21002188.IP
21012189.nf
21022190\f[C]
@@ -2145,7 +2233,7 @@ The nested list must be indented four spaces or one tab:
21452233\f[]
21462234.fi
21472235.PP
2148−As noted above, markdown allows you to write list items "lazily,"
2236+As noted above, Markdown allows you to write list items "lazily,"
21492237instead of indenting continuation lines.
21502238However, if there are multiple paragraphs or other blocks in a list
21512239item, the first line of each must be indented.
@@ -2164,12 +2252,12 @@ list\ item.
21642252.fi
21652253.PP
21662254\f[B]Note:\f[] Although the four\-space rule for continuation paragraphs
2167−comes from the official markdown syntax guide, the reference
2255+comes from the official Markdown syntax guide, the reference
21682256implementation, \f[C]Markdown.pl\f[], does not follow it.
21692257So pandoc will give different results than \f[C]Markdown.pl\f[] when
21702258authors have indented continuation paragraphs fewer than four spaces.
21712259.PP
2172−The markdown syntax guide is not explicit whether the four\-space rule
2260+The Markdown syntax guide is not explicit whether the four\-space rule
21732261applies to \f[I]all\f[] block\-level content in a list item; it only
21742262mentions paragraphs and code blocks.
21752263But it implies that the rule applies to all block\-level content
@@ -2179,7 +2267,7 @@ But it implies that the rule applies to all block\-level content
21792267Ordered lists work just like bulleted lists, except that the items begin
21802268with enumerators rather than bullets.
21812269.PP
2182−In standard markdown, enumerators are decimal numbers followed by a
2270+In standard Markdown, enumerators are decimal numbers followed by a
21832271period and a space.
21842272The numbers themselves are ignored, so there is no difference between
21852273this list:
@@ -2203,7 +2291,7 @@ and this one:
22032291.fi
22042292.SS Extension: \f[C]fancy_lists\f[]
22052293.PP
2206−Unlike standard markdown, Pandoc allows ordered list items to be marked
2294+Unlike standard Markdown, pandoc allows ordered list items to be marked
22072295with uppercase and lowercase letters and roman numerals, in addition to
22082296arabic numerals.
22092297List markers may be enclosed in parentheses or followed by a single
@@ -2295,7 +2383,7 @@ one or more block elements (paragraph, code block, list, etc.), each
22952383indented four spaces or one tab stop.
22962384The body of the definition (including the first line, aside from the
22972385colon or tilde) should be indented four spaces.
2298−However, as with other markdown lists, you can "lazily" omit indentation
2386+However, as with other Markdown lists, you can "lazily" omit indentation
22992387except at the beginning of a paragraph or other block element:
23002388.IP
23012389.nf
@@ -2385,7 +2473,7 @@ Consider this source:
23852473.fi
23862474.PP
23872475Pandoc transforms this into a "compact list" (with no \f[C]<p>\f[] tags
2388−around "First", "Second", or "Third"), while markdown puts \f[C]<p>\f[]
2476+around "First", "Second", or "Third"), while Markdown puts \f[C]<p>\f[]
23892477tags around "Second" and "Third" (but not "First"), because of the blank
23902478space around "Third".
23912479Pandoc follows a simple rule: if the text is followed by a blank line,
@@ -2395,7 +2483,7 @@ treated as a paragraph.
23952483The fact that the list is followed by a blank line is irrelevant.
23962484(Note: Pandoc works this way even when the \f[C]markdown_strict\f[]
23972485format is specified.
2398−This behavior is consistent with the official markdown syntax
2486+This behavior is consistent with the official Markdown syntax
23992487description, even though it is different from that of
24002488\f[C]Markdown.pl\f[].)
24012489.SS Ending a list
@@ -2411,7 +2499,7 @@ What if you want to put an indented code block after a list?
24112499\f[]
24122500.fi
24132501.PP
2414−Trouble! Here pandoc (like other markdown implementations) will treat
2502+Trouble! Here pandoc (like other Markdown implementations) will treat
24152503\f[C]{\ my\ code\ block\ }\f[] as the second paragraph of item two, and
24162504not as a code block.
24172505.PP
@@ -2565,7 +2653,7 @@ In multiline tables, the table parser pays attention to the widths of
25652653the columns, and the writers try to reproduce these relative widths in
25662654the output.
25672655So, if you find that one of the columns is too narrow in the output, try
2568−widening it in the markdown source.
2656+widening it in the Markdown source.
25692657.PP
25702658Headers may be omitted in multiline tables as well as simple tables:
25712659.IP
@@ -2658,7 +2746,7 @@ will not wrap, since there is no information available about relative
26582746widths.
26592747If you want content to wrap within cells, use multiline or grid tables.
26602748.PP
2661−Note: Pandoc also recognizes pipe tables of the following form, as can
2749+Note: pandoc also recognizes pipe tables of the following form, as can
26622750be produced by Emacs\[aq] orgtbl\-mode:
26632751.IP
26642752.nf
@@ -2791,7 +2879,7 @@ A YAML metadata block may occur anywhere in the document, but if it is
27912879not at the beginning, it must be preceded by a blank line.
27922880(Note that, because of the way pandoc concatenates input files when
27932881several are provided, you may also keep the metadata in a separate YAML
2794−file and pass it to pandoc as an argument, along with your markdown
2882+file and pass it to pandoc as an argument, along with your Markdown
27952883files:
27962884.IP
27972885.nf
@@ -2806,7 +2894,7 @@ with \f[C]\-\-\-\f[] or \f[C]\&...\f[].)
28062894Metadata will be taken from the fields of the YAML object and added to
28072895any existing document metadata.
28082896Metadata can contain lists and objects (nested arbitrarily), but all
2809−string scalars will be interpreted as markdown.
2897+string scalars will be interpreted as Markdown.
28102898Fields with names ending in an underscore will be ignored by pandoc.
28112899(They may be given a role by external processors.)
28122900.PP
@@ -2815,7 +2903,7 @@ The metadata fields will be combined through a \f[I]left\-biased
28152903union\f[]: if two metadata blocks attempt to set the same field, the
28162904value from the first block will be taken.
28172905.PP
2818−When pandoc is used with \f[C]\-t\ markdown\f[] to create a markdown
2906+When pandoc is used with \f[C]\-t\ markdown\f[] to create a Markdown
28192907document, a YAML metadata block will be produced only if the
28202908\f[C]\-s/\-\-standalone\f[] option is used.
28212909All of the metadata will appear in a single block at the beginning of
@@ -2847,7 +2935,7 @@ abstract:\ |
28472935.PP
28482936Template variables will be set automatically from the metadata.
28492937Thus, for example, in writing HTML, the variable \f[C]abstract\f[] will
2850−be set to the HTML equivalent of the markdown in the \f[C]abstract\f[]
2938+be set to the HTML equivalent of the Markdown in the \f[C]abstract\f[]
28512939field:
28522940.IP
28532941.nf
@@ -2904,7 +2992,7 @@ instead of
29042992\f[]
29052993.fi
29062994.PP
2907−This rule is easier to remember than standard markdown\[aq]s rule, which
2995+This rule is easier to remember than standard Markdown\[aq]s rule, which
29082996allows only the following characters to be backslash\-escaped:
29092997.IP
29102998.nf
@@ -2914,7 +3002,7 @@ allows only the following characters to be backslash\-escaped:
29143002.fi
29153003.PP
29163004(However, if the \f[C]markdown_strict\f[] format is used, the standard
2917−markdown rule will be used.)
3005+Markdown rule will be used.)
29183006.PP
29193007A backslash\-escaped space is parsed as a nonbreaking space.
29203008It will appear in TeX output as \f[C]~\f[] and in HTML and XML as
@@ -2925,7 +3013,7 @@ a backslash occurring at the end of a line) is parsed as a hard line
29253013break.
29263014It will appear in TeX output as \f[C]\\\\\f[] and in HTML as
29273015\f[C]<br\ />\f[].
2928−This is a nice alternative to markdown\[aq]s "invisible" way of
3016+This is a nice alternative to Markdown\[aq]s "invisible" way of
29293017indicating hard line breaks using two trailing spaces on a line.
29303018.PP
29313019Backslash escapes do not work in verbatim contexts.
@@ -3040,7 +3128,7 @@ The general rule is that a verbatim span starts with a string of
30403128consecutive backticks (optionally followed by a space) and ends with a
30413129string of the same number of backticks (optionally preceded by a space).
30423130.PP
3043−Note that backslash\-escapes (and other markdown constructs) do not work
3131+Note that backslash\-escapes (and other Markdown constructs) do not work
30443132in verbatim contexts:
30453133.IP
30463134.nf
@@ -3212,7 +3300,7 @@ The MathJax script will be used to render it as formulas.
32123300Markdown allows you to insert raw HTML (or DocBook) anywhere in a
32133301document (except verbatim contexts, where \f[C]<\f[], \f[C]>\f[], and
32143302\f[C]&\f[] are interpreted literally).
3215−(Technically this is not an extension, since standard markdown allows
3303+(Technically this is not an extension, since standard Markdown allows
32163304it, but it has been made an extension so that it can be disabled if
32173305desired.)
32183306.PP
@@ -3221,16 +3309,16 @@ DZSlides, EPUB, Markdown, and Textile output, and suppressed in other
32213309formats.
32223310.SS Extension: \f[C]markdown_in_html_blocks\f[]
32233311.PP
3224−Standard markdown allows you to include HTML "blocks": blocks of HTML
3312+Standard Markdown allows you to include HTML "blocks": blocks of HTML
32253313between balanced tags that are separated from the surrounding text with
32263314blank lines, and start and end at the left margin.
3227−Within these blocks, everything is interpreted as HTML, not markdown; so
3315+Within these blocks, everything is interpreted as HTML, not Markdown; so
32283316(for example), \f[C]*\f[] does not signify emphasis.
32293317.PP
32303318Pandoc behaves this way when the \f[C]markdown_strict\f[] format is
32313319used; but by default, pandoc interprets material between HTML block tags
3232−as markdown.
3233−Thus, for example, Pandoc will turn
3320+as Markdown.
3321+Thus, for example, pandoc will turn
32343322.IP
32353323.nf
32363324\f[C]
@@ -3259,13 +3347,13 @@ into
32593347whereas \f[C]Markdown.pl\f[] will preserve it as is.
32603348.PP
32613349There is one exception to this rule: text between \f[C]<script>\f[] and
3262−\f[C]<style>\f[] tags is not interpreted as markdown.
3350+\f[C]<style>\f[] tags is not interpreted as Markdown.
32633351.PP
3264−This departure from standard markdown should make it easier to mix
3265−markdown with HTML block elements.
3266−For example, one can surround a block of markdown text with
3352+This departure from standard Markdown should make it easier to mix
3353+Markdown with HTML block elements.
3354+For example, one can surround a block of Markdown text with
32673355\f[C]<div>\f[] tags without preventing it from being interpreted as
3268−markdown.
3356+Markdown.
32693357.SS Extension: \f[C]native_divs\f[]
32703358.PP
32713359Use native pandoc \f[C]Div\f[] blocks for content inside \f[C]<div>\f[]
@@ -3309,7 +3397,7 @@ Age\ &\ Frequency\ \\\\\ \\hline
33093397.fi
33103398.PP
33113399the material between the begin and end tags will be interpreted as raw
3312−LaTeX, not as markdown.
3400+LaTeX, not as Markdown.
33133401.PP
33143402Inline LaTeX is ignored in output formats other than Markdown, LaTeX,
33153403and ConTeXt.
@@ -3432,7 +3520,7 @@ See\ [my\ website][].
34323520\f[]
34333521.fi
34343522.PP
3435−Note: In \f[C]Markdown.pl\f[] and most other markdown implementations,
3523+Note: In \f[C]Markdown.pl\f[] and most other Markdown implementations,
34363524reference link definitions cannot occur in nested constructions such as
34373525list items or block quotes.
34383526Pandoc lifts this arbitrary seeming restriction.
@@ -3522,7 +3610,7 @@ One way to do this is to insert a nonbreaking space after the image:
35223610.SS Footnotes
35233611.SS Extension: \f[C]footnotes\f[]
35243612.PP
3525−Pandoc\[aq]s markdown allows footnotes, using the following syntax:
3613+Pandoc\[aq]s Markdown allows footnotes, using the following syntax:
35263614.IP
35273615.nf
35283616\f[C]
@@ -3665,7 +3753,7 @@ Note that \f[C]pandoc\-citeproc\ \-\-bib2json\f[] and
36653753\f[C]\&.yaml\f[] files from any of the supported formats.
36663754.PP
36673755In\-field markup: In BibTeX and BibLaTeX databases, pandoc\-citeproc
3668−parses a subset of LaTeX markup; in CSL YAML databases, pandoc markdown;
3756+parses a subset of LaTeX markup; in CSL YAML databases, pandoc Markdown;
36693757and in CSL JSON databases, an HTML\-like markup:
36703758.TP
36713759.B \f[C]<i>...</i>\f[]
@@ -3851,10 +3939,10 @@ Bear in mind that bibliography files have to be in respective format
38513939(either BibTeX or BibLaTeX).
38523940.SS Non\-pandoc extensions
38533941.PP
3854−The following markdown syntax extensions are not enabled by default in
3942+The following Markdown syntax extensions are not enabled by default in
38553943pandoc, but may be enabled by adding \f[C]+EXTENSION\f[] to the format
38563944name, where \f[C]EXTENSION\f[] is the name of the extension.
3857−Thus, for example, \f[C]markdown+hard_line_breaks\f[] is markdown with
3945+Thus, for example, \f[C]markdown+hard_line_breaks\f[] is Markdown with
38583946hard line breaks.
38593947.SS Extension: \f[C]lists_without_preceding_blankline\f[]
38603948.PP
@@ -3886,8 +3974,8 @@ interpreted as inline TeX math, and anything between \f[C]\\\\[\f[] and
38863974.SS Extension: \f[C]markdown_attribute\f[]
38873975.PP
38883976By default, pandoc interprets material inside block\-level tags as
3889−markdown.
3890−This extension changes the behavior so that markdown is only parsed
3977+Markdown.
3978+This extension changes the behavior so that Markdown is only parsed
38913979inside block\-level tags if the tags have the attribute
38923980\f[C]markdown=1\f[].
38933981.SS Extension: \f[C]mmd_title_block\f[]
@@ -3958,7 +4046,7 @@ Lazy wrapping of paragraphs is not allowed: the entire definition must
39584046be indented four spaces.
39594047.SS Markdown variants
39604048.PP
3961−In addition to pandoc\[aq]s extended markdown, the following markdown
4049+In addition to pandoc\[aq]s extended Markdown, the following Markdown
39624050variants are supported:
39634051.TP
39644052.B \f[C]markdown_phpextra\f[] (PHP Markdown Extra)
@@ -3995,10 +4083,10 @@ variants are supported:
39954083\f[C]raw_html\f[]
39964084.RS
39974085.RE
3998−.SS Extensions with formats other than markdown
4086+.SS Extensions with formats other than Markdown
39994087.PP
40004088Some of the extensions discussed above can be used with formats other
4001−than markdown:
4089+than Markdown:
40024090.IP \[bu] 2
40034091\f[C]auto_identifiers\f[] can be used with \f[C]latex\f[], \f[C]rst\f[],
40044092\f[C]mediawiki\f[], and \f[C]textile\f[] input (and is used by default).
@@ -4009,13 +4097,13 @@ than markdown:
40094097example.)
40104098.SH PRODUCING SLIDE SHOWS WITH PANDOC
40114099.PP
4012−You can use Pandoc to produce an HTML + javascript slide presentation
4100+You can use pandoc to produce an HTML + javascript slide presentation
40134101that can be viewed via a web browser.
40144102There are five ways to do this, using S5, DZSlides, Slidy, Slideous, or
40154103reveal.js.
40164104You can also produce a PDF slide show using LaTeX \f[C]beamer\f[].
40174105.PP
4018−Here\[aq]s the markdown source for a simple slide show,
4106+Here\[aq]s the Markdown source for a simple slide show,
40194107\f[C]habits.txt\f[]:
40204108.IP
40214109.nf
@@ -4219,14 +4307,14 @@ This is recommended especially for bibliographies:
42194307.SS Speaker notes
42204308.PP
42214309reveal.js has good support for speaker notes.
4222−You can add notes to your markdown document thus:
4310+You can add notes to your Markdown document thus:
42234311.IP
42244312.nf
42254313\f[C]
42264314<div\ class="notes">
42274315This\ is\ my\ note.
42284316
4229−\-\ It\ can\ contain\ markdown
4317+\-\ It\ can\ contain\ Markdown
42304318\-\ like\ this\ list
42314319
42324320</div>
@@ -4255,10 +4343,11 @@ All of the other frame attributes described in Section 8.1 of the Beamer
42554343User\[aq]s Guide may also be used: \f[C]allowdisplaybreaks\f[],
42564344\f[C]allowframebreaks\f[], \f[C]b\f[], \f[C]c\f[], \f[C]t\f[],
42574345\f[C]environment\f[], \f[C]label\f[], \f[C]plain\f[], \f[C]shrink\f[].
4258−.SH EPUB METADATA
4346+.SH CREATING EPUBS WITH PANDOC
4347+.SS EPUB Metadata
42594348.PP
42604349EPUB metadata may be specified using the \f[C]\-\-epub\-metadata\f[]
4261−option, but if the source document is markdown, it is better to use a
4350+option, but if the source document is Markdown, it is better to use a
42624351YAML metadata block.
42634352Here is an example:
42644353.IP
@@ -4384,6 +4473,24 @@ Specifies the \f[C]page\-progression\-direction\f[] attribute for the
43844473\f[C]spine\f[] element.
43854474.RS
43864475.RE
4476+.SS Linked media
4477+.PP
4478+By default, pandoc will download linked media (including audio and
4479+video) and include it in the EPUB container, yielding a completely
4480+self\-contained EPUB.
4481+If you want to link to external media resources instead, use raw HTML in
4482+your source and add \f[C]data\-external="1"\f[] to the tag with the
4483+\f[C]src\f[] attribute.
4484+For example:
4485+.IP
4486+.nf
4487+\f[C]
4488+<audio\ controls="1">
4489+\ <source\ src="http://www.sixbarsjail.it/tmp/bach_toccata.mp3"
4490+\ data\-external="1"\ type="audio/mpeg"></source>
4491+</audio>
4492+\f[]
4493+.fi
43874494.SH LITERATE HASKELL SUPPORT
43884495.PP
43894496If you append \f[C]+lhs\f[] (or \f[C]+literate_haskell\f[]) to an
@@ -4393,14 +4500,14 @@ output; \f[C]beamer\f[], \f[C]html\f[] or \f[C]html5\f[] for output
43934500only), pandoc will treat the document as literate Haskell source.
43944501This means that
43954502.IP \[bu] 2
4396−In markdown input, "bird track" sections will be parsed as Haskell code
4503+In Markdown input, "bird track" sections will be parsed as Haskell code
43974504rather than block quotations.
43984505Text between \f[C]\\begin{code}\f[] and \f[C]\\end{code}\f[] will also
43994506be treated as Haskell code.
44004507For ATX\-style headers the character \[aq]=\[aq] will be used instead of
44014508\[aq]#\[aq].
44024509.IP \[bu] 2
4403−In markdown output, code blocks with classes \f[C]haskell\f[] and
4510+In Markdown output, code blocks with classes \f[C]haskell\f[] and
44044511\f[C]literate\f[] will be rendered using bird tracks, and block
44054512quotations will be indented one space, so they will not be treated as
44064513Haskell code.
@@ -4432,7 +4539,7 @@ pandoc\ \-f\ markdown+lhs\ \-t\ html
44324539\f[]
44334540.fi
44344541.PP
4435−reads literate Haskell source formatted with markdown conventions and
4542+reads literate Haskell source formatted with Markdown conventions and
44364543writes ordinary HTML (without bird tracks).
44374544.IP
44384545.nf
@@ -4494,9 +4601,10 @@ This software carries no warranty of any kind.
44944601.PP
44954602Contributors include Aaron Wolen, Albert Krewinkel, Alexander
44964603Kondratskiy, Alexander Sulfrian, Alexander V Vershilov, Alfred
4497−Wechselberger, Andreas Lööw, Andrew Dunning, Antoine Latter, Arlo
4498−O\[aq]Keeffe, Artyom Kazak, Ben Gamari, Beni Cherniavsky\-Paskin, Bjorn
4499−Buckwalter, Bradley Kuhn, Brent Yorgey, Bryan O\[aq]Sullivan, B.
4604+Wechselberger, Andreas Lööw, Andrew Dunning, Antoine Latter, Arata
4605+Mizuki, Arlo O\[aq]Keeffe, Artyom Kazak, Ben Gamari, Beni
4606+Cherniavsky\-Paskin, Bjorn Buckwalter, Bradley Kuhn, Brent Yorgey, Bryan
4607+O\[aq]Sullivan, B.
45004608Scott Michel, Caleb McDaniel, Calvin Beck, Christoffer Ackelman,
45014609Christoffer Sawicki, Clare Macrae, Clint Adams, Conal Elliott, Craig S.
45024610Bosma, Daniel Bergey, Daniel T.