@@ -403,8 +403,6 @@ Write output to \f[I]FILE\f[R] instead of \f[I]stdout\f[R].
403403If \f[I]FILE\f[R] is \f[C]\-\f[R], output will go to \f[I]stdout\f[R],
404404even if a non\-textual format (\f[C]docx\f[R], \f[C]odt\f[R],
405405\f[C]epub2\f[R], \f[C]epub3\f[R]) is specified.
406−.RS
407−.RE
408406.TP
409407.B \f[C]\-\-data\-dir=\f[R]\f[I]DIRECTORY\f[R]
410408Specify the user data directory to search for pandoc data files.
@@ -459,35 +457,23 @@ eval\ \[dq]$(pandoc\ \-\-bash\-completion)\[dq]
459457.B \f[C]\-\-verbose\f[R]
460458Give verbose debugging output.
461459Currently this only has an effect with PDF output.
462−.RS
463−.RE
464460.TP
465461.B \f[C]\-\-quiet\f[R]
466462Suppress warning messages.
467−.RS
468−.RE
469463.TP
470464.B \f[C]\-\-fail\-if\-warnings\f[R]
471465Exit with error status if there are any warnings.
472−.RS
473−.RE
474466.TP
475467.B \f[C]\-\-log=\f[R]\f[I]FILE\f[R]
476468Write log messages in machine\-readable JSON format to \f[I]FILE\f[R].
477469All messages above DEBUG level will be written, regardless of verbosity
478470settings (\f[C]\-\-verbose\f[R], \f[C]\-\-quiet\f[R]).
479−.RS
480−.RE
481471.TP
482472.B \f[C]\-\-list\-input\-formats\f[R]
483473List supported input formats, one per line.
484−.RS
485−.RE
486474.TP
487475.B \f[C]\-\-list\-output\-formats\f[R]
488476List supported output formats, one per line.
489−.RS
490−.RE
491477.TP
492478.B \f[C]\-\-list\-extensions\f[R][\f[C]=\f[R]\f[I]FORMAT\f[R]]
493479List supported extensions, one per line, preceded by a \f[C]+\f[R] or
@@ -495,50 +481,34 @@ List supported extensions, one per line, preceded by a \f[C]+\f[R] or
495481\f[I]FORMAT\f[R].
496482If \f[I]FORMAT\f[R] is not specified, defaults for pandoc\[aq]s Markdown
497483are given.
498−.RS
499−.RE
500484.TP
501485.B \f[C]\-\-list\-highlight\-languages\f[R]
502486List supported languages for syntax highlighting, one per line.
503−.RS
504−.RE
505487.TP
506488.B \f[C]\-\-list\-highlight\-styles\f[R]
507489List supported styles for syntax highlighting, one per line.
508490See \f[C]\-\-highlight\-style\f[R].
509−.RS
510−.RE
511491.TP
512492.B \f[C]\-v\f[R], \f[C]\-\-version\f[R]
513493Print version.
514−.RS
515−.RE
516494.TP
517495.B \f[C]\-h\f[R], \f[C]\-\-help\f[R]
518496Show usage message.
519−.RS
520−.RE
521497.SS Reader options
522498.TP
523499.B \f[C]\-\-base\-header\-level=\f[R]\f[I]NUMBER\f[R]
524500Specify the base level for headers (defaults to 1).
525−.RS
526−.RE
527501.TP
528502.B \f[C]\-\-strip\-empty\-paragraphs\f[R]
529503\f[I]Deprecated. Use the \f[CI]+empty_paragraphs\f[I] extension
530504instead.\f[R] Ignore paragraphs with no content.
531505This option is useful for converting word processing documents where
532506users have used empty paragraphs to create inter\-paragraph space.
533−.RS
534−.RE
535507.TP
536508.B \f[C]\-\-indented\-code\-classes=\f[R]\f[I]CLASSES\f[R]
537509Specify classes to use for indented code blocks\-\-for example,
538510\f[C]perl,numberLines\f[R] or \f[C]haskell\f[R].
539511Multiple classes may be separated by spaces or commas.
540−.RS
541−.RE
542512.TP
543513.B \f[C]\-\-default\-image\-extension=\f[R]\f[I]EXTENSION\f[R]
544514Specify a default extension to use when image paths/URLs have no
@@ -546,8 +516,6 @@ extension.
546516This allows you to use the same source for formats that require
547517different kinds of images.
548518Currently this option only affects the Markdown and LaTeX readers.
549−.RS
550−.RE
551519.TP
552520.B \f[C]\-\-file\-scope\f[R]
553521Parse each file individually before combining for multifile documents.
@@ -556,8 +524,6 @@ to work as expected.
556524If this option is set, footnotes and links will not work across files.
557525Reading binary files (docx, odt, epub) implies
558526\f[C]\-\-file\-scope\f[R].
559−.RS
560−.RE
561527.TP
562528.B \f[C]\-F\f[R] \f[I]PROGRAM\f[R], \f[C]\-\-filter=\f[R]\f[I]PROGRAM\f[R]
563529Specify an executable to be used as a filter transforming the pandoc AST
@@ -659,8 +625,6 @@ But unlike \f[C]\-\-variable\f[R], \f[C]\-\-metadata\f[R] affects the
659625metadata of the underlying document (which is accessible from filters
660626and may be printed in some output formats) and metadata values will be
661627escaped when inserted into the template.
662−.RS
663−.RE
664628.TP
665629.B \f[C]\-\-metadata\-file=\f[R]\f[I]FILE\f[R]
666630Read metadata from the supplied YAML (or JSON) file.
@@ -670,20 +634,14 @@ Generally, the input will be handled the same as in YAML metadata
670634blocks.
671635Metadata values specified inside the document, or by using
672636\f[C]\-M\f[R], overwrite values specified with this option.
673−.RS
674−.RE
675637.TP
676638.B \f[C]\-p\f[R], \f[C]\-\-preserve\-tabs\f[R]
677639Preserve tabs instead of converting them to spaces (the default).
678640Note that this will only affect tabs in literal code spans and code
679641blocks; tabs in regular text will be treated as spaces.
680−.RS
681−.RE
682642.TP
683643.B \f[C]\-\-tab\-stop=\f[R]\f[I]NUMBER\f[R]
684644Specify the number of spaces per tab (default is 4).
685−.RS
686−.RE
687645.TP
688646.B \f[C]\-\-track\-changes=accept\f[R]|\f[C]reject\f[R]|\f[C]all\f[R]
689647Specifies what to do with insertions, deletions, and comments produced
@@ -704,8 +662,6 @@ produces a span with the class
704662\f[C]paragraph\-insertion\f[R]/\f[C]paragraph\-deletion\f[R] before the
705663affected paragraph break.
706664This option only affects the docx reader.
707−.RS
708−.RE
709665.TP
710666.B \f[C]\-\-extract\-media=\f[R]\f[I]DIR\f[R]
711667Extract images and other media contained in or linked from the source
@@ -717,8 +673,6 @@ media is extracted from the container and the original filenames are
717673used.
718674Otherwise the media is read from the file system or downloaded, and new
719675filenames are constructed based on SHA1 hashes of the contents.
720−.RS
721−.RE
722676.TP
723677.B \f[C]\-\-abbreviations=\f[R]\f[I]FILE\f[R]
724678Specifies a custom abbreviations file, with abbreviations one to a line.
@@ -731,8 +685,6 @@ The only use pandoc makes of this list is in the Markdown reader.
731685Strings ending in a period that are found in this list will be followed
732686by a nonbreaking space, so that the period will not produce
733687sentence\-ending space in formats like LaTeX.
734−.RS
735−.RE
736688.SS General writer options
737689.TP
738690.B \f[C]\-s\f[R], \f[C]\-\-standalone\f[R]
@@ -743,8 +695,6 @@ This option is set automatically for \f[C]pdf\f[R], \f[C]epub\f[R],
743695output.
744696For \f[C]native\f[R] output, this option causes metadata to be included;
745697otherwise, metadata is suppressed.
746−.RS
747−.RE
748698.TP
749699.B \f[C]\-\-template=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
750700Use the specified file as a custom template for the generated document.
@@ -759,8 +709,6 @@ If the template is not found, pandoc will search for it in the
759709If this option is not used, a default template appropriate for the
760710output format will be used (see
761711\f[C]\-D/\-\-print\-default\-template\f[R]).
762−.RS
763−.RE
764712.TP
765713.B \f[C]\-V\f[R] \f[I]KEY\f[R][\f[C]=\f[R]\f[I]VAL\f[R]], \f[C]\-\-variable=\f[R]\f[I]KEY\f[R][\f[C]:\f[R]\f[I]VAL\f[R]]
766714Set the template variable \f[I]KEY\f[R] to the value \f[I]VAL\f[R] when
@@ -770,37 +718,27 @@ used to specify a custom template, since pandoc automatically sets the
770718variables used in the default templates.
771719If no \f[I]VAL\f[R] is specified, the key will be given the value
772720\f[C]true\f[R].
773−.RS
774−.RE
775721.TP
776722.B \f[C]\-D\f[R] \f[I]FORMAT\f[R], \f[C]\-\-print\-default\-template=\f[R]\f[I]FORMAT\f[R]
777723Print the system default template for an output \f[I]FORMAT\f[R].
778724(See \f[C]\-t\f[R] for a list of possible \f[I]FORMAT\f[R]s.) Templates
779725in the user data directory are ignored.
780−.RS
781−.RE
782726.TP
783727.B \f[C]\-\-print\-default\-data\-file=\f[R]\f[I]FILE\f[R]
784728Print a system default data file.
785729Files in the user data directory are ignored.
786−.RS
787−.RE
788730.TP
789731.B \f[C]\-\-eol=crlf\f[R]|\f[C]lf\f[R]|\f[C]native\f[R]
790732Manually specify line endings: \f[C]crlf\f[R] (Windows), \f[C]lf\f[R]
791733(macOS/Linux/UNIX), or \f[C]native\f[R] (line endings appropriate to the
792734OS on which pandoc is being run).
793735The default is \f[C]native\f[R].
794−.RS
795−.RE
796736.TP
797737.B \f[C]\-\-dpi\f[R]=\f[I]NUMBER\f[R]
798738Specify the dpi (dots per inch) value for conversion from pixels to
799739inch/centimeters and vice versa.
800740The default is 96dpi.
801741Technically, the correct term would be ppi (pixels per inch).
802−.RS
803−.RE
804742.TP
805743.B \f[C]\-\-wrap=auto\f[R]|\f[C]none\f[R]|\f[C]preserve\f[R]
806744Determine how text is wrapped in the output (the source code, not the
@@ -813,8 +751,6 @@ from the source document (that is, where there are nonsemantic newlines
813751in the source, there will be nonsemantic newlines in the output as
814752well).
815753Automatic wrapping does not currently work in HTML output.
816−.RS
817−.RE
818754.TP
819755.B \f[C]\-\-columns=\f[R]\f[I]NUMBER\f[R]
820756Specify length of lines in characters.
@@ -822,8 +758,6 @@ This affects text wrapping in the generated source code (see
822758\f[C]\-\-wrap\f[R]).
823759It also affects calculation of column widths for plain text tables (see
824760Tables below).
825−.RS
826−.RE
827761.TP
828762.B \f[C]\-\-toc\f[R], \f[C]\-\-table\-of\-contents\f[R]
829763Include an automatically generated table of contents (or, in the case of
@@ -833,30 +767,22 @@ to create one) in the output document.
833767This option has no effect unless \f[C]\-s/\-\-standalone\f[R] is used,
834768and it has no effect on \f[C]man\f[R], \f[C]docbook4\f[R],
835769\f[C]docbook5\f[R], or \f[C]jats\f[R] output.
836−.RS
837−.RE
838770.TP
839771.B \f[C]\-\-toc\-depth=\f[R]\f[I]NUMBER\f[R]
840772Specify the number of section levels to include in the table of
841773contents.
842774The default is 3 (which means that level 1, 2, and 3 headers will be
843775listed in the contents).
844−.RS
845−.RE
846776.TP
847777.B \f[C]\-\-strip\-comments\f[R]
848778Strip out HTML comments in the Markdown or Textile source, rather than
849779passing them on to Markdown, Textile or HTML output as raw HTML.
850780This does not apply to HTML comments inside raw HTML blocks when the
851781\f[C]markdown_in_html_blocks\f[R] extension is not set.
852−.RS
853−.RE
854782.TP
855783.B \f[C]\-\-no\-highlight\f[R]
856784Disables syntax highlighting for code blocks and inlines, even when a
857785language attribute is given.
858−.RS
859−.RE
860786.TP
861787.B \f[C]\-\-highlight\-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
862788Specifies the coloring style to be used in highlighted source code.
@@ -881,16 +807,12 @@ To generate the JSON version of an existing style, use
881807Prints a JSON version of a highlighting style, which can be modified,
882808saved with a \f[C]\&.theme\f[R] extension, and used with
883809\f[C]\-\-highlight\-style\f[R].
884−.RS
885−.RE
886810.TP
887811.B \f[C]\-\-syntax\-definition=\f[R]\f[I]FILE\f[R]
888812Instructs pandoc to load a KDE XML syntax definition file, which will be
889813used for syntax highlighting of appropriately marked code blocks.
890814This can be used to add support for new languages or to use altered
891815syntax definitions for existing languages.
892−.RS
893−.RE
894816.TP
895817.B \f[C]\-H\f[R] \f[I]FILE\f[R], \f[C]\-\-include\-in\-header=\f[R]\f[I]FILE\f[R]
896818Include contents of \f[I]FILE\f[R], verbatim, at the end of the header.
@@ -900,8 +822,6 @@ This option can be used repeatedly to include multiple files in the
900822header.
901823They will be included in the order specified.
902824Implies \f[C]\-\-standalone\f[R].
903−.RS
904−.RE
905825.TP
906826.B \f[C]\-B\f[R] \f[I]FILE\f[R], \f[C]\-\-include\-before\-body=\f[R]\f[I]FILE\f[R]
907827Include contents of \f[I]FILE\f[R], verbatim, at the beginning of the
@@ -913,8 +833,6 @@ documents.
913833This option can be used repeatedly to include multiple files.
914834They will be included in the order specified.
915835Implies \f[C]\-\-standalone\f[R].
916−.RS
917−.RE
918836.TP
919837.B \f[C]\-A\f[R] \f[I]FILE\f[R], \f[C]\-\-include\-after\-body=\f[R]\f[I]FILE\f[R]
920838Include contents of \f[I]FILE\f[R], verbatim, at the end of the document
@@ -923,8 +841,6 @@ body (before the \f[C]</body>\f[R] tag in HTML, or the
923841This option can be used repeatedly to include multiple files.
924842They will be included in the order specified.
925843Implies \f[C]\-\-standalone\f[R].
926−.RS
927−.RE
928844.TP
929845.B \f[C]\-\-resource\-path=\f[R]\f[I]SEARCHPATH\f[R]
930846List of paths to search for images and other resources.
@@ -950,8 +866,6 @@ making HTTP requests (for example, when a URL is given on the command
950866line, or when resources used in a document must be downloaded).
951867If you\[aq]re behind a proxy, you also need to set the environment
952868variable \f[C]http_proxy\f[R] to \f[C]http://...\f[R].
953−.RS
954−.RE
955869.SS Options affecting specific writers
956870.TP
957871.B \f[C]\-\-self\-contained\f[R]
@@ -978,13 +892,9 @@ cannot be incorporated; as a result, \f[C]\-\-self\-contained\f[R] does
978892not work with \f[C]\-\-mathjax\f[R], and some advanced features (e.g.
979893zoom or speaker notes) may not work in an offline
980894\[dq]self\-contained\[dq] \f[C]reveal.js\f[R] slide show.
981−.RS
982−.RE
983895.TP
984896.B \f[C]\-\-html\-q\-tags\f[R]
985897Use \f[C]<q>\f[R] tags for quotes in HTML.
986−.RS
987−.RE
988898.TP
989899.B \f[C]\-\-ascii\f[R]
990900Use only ASCII characters in output.
@@ -993,8 +903,6 @@ entities instead of UTF\-8 when this option is selected), groff ms
993903(which use hexadecimal escapes), and to a limited degree LaTeX (which
994904uses standard commands for accented characters when possible).
995905Groff man output uses ASCII by default.
996−.RS
997−.RE
998906.TP
999907.B \f[C]\-\-reference\-links\f[R]
1000908Use reference\-style links, rather than inline links, in writing
@@ -1002,8 +910,6 @@ Markdown or reStructuredText.
1002910By default inline links are used.
1003911The placement of link references is affected by the
1004912\f[C]\-\-reference\-location\f[R] option.
1005−.RS
1006−.RE
1007913.TP
1008914.B \f[C]\-\-reference\-location\ =\ block\f[R]|\f[C]section\f[R]|\f[C]document\f[R]
1009915Specify whether footnotes (and references, if \f[C]reference\-links\f[R]
@@ -1011,16 +917,12 @@ is set) are placed at the end of the current (top\-level) block, the
1011917current section, or the document.
1012918The default is \f[C]document\f[R].
1013919Currently only affects the markdown writer.
1014−.RS
1015−.RE
1016920.TP
1017921.B \f[C]\-\-atx\-headers\f[R]
1018922Use ATX\-style headers in Markdown and AsciiDoc output.
1019923The default is to use setext\-style headers for levels 1\-2, and then
1020924ATX headers.
1021925(Note: for \f[C]gfm\f[R] output, ATX headers are always used.)
1022−.RS
1023−.RE
1024926.TP
1025927.B \f[C]\-\-top\-level\-division=[default|section|chapter|part]\f[R]
1026928Treat top\-level headers as the given division type in LaTeX, ConTeXt,
@@ -1037,16 +939,12 @@ If \f[C]beamer\f[R] is the output format, specifying either
1037939\f[C]chapter\f[R] or \f[C]part\f[R] will cause top\-level headers to
1038940become \f[C]\[rs]part{..}\f[R], while second\-level headers remain as
1039941their default type.
1040−.RS
1041−.RE
1042942.TP
1043943.B \f[C]\-N\f[R], \f[C]\-\-number\-sections\f[R]
1044944Number section headings in LaTeX, ConTeXt, HTML, or EPUB output.
1045945By default, sections are not numbered.
1046946Sections with class \f[C]unnumbered\f[R] will never be numbered, even if
1047947\f[C]\-\-number\-sections\f[R] is specified.
1048−.RS
1049−.RE
1050948.TP
1051949.B \f[C]\-\-number\-offset=\f[R]\f[I]NUMBER\f[R][\f[C],\f[R]\f[I]NUMBER\f[R]\f[C],\f[R]\f[I]...\f[R]]
1052950Offset for section headings in HTML output (ignored in other output
@@ -1060,8 +958,6 @@ If your document starts with a level\-2 header which you want to be
1060958numbered \[dq]1.5\[dq], specify \f[C]\-\-number\-offset=1,4\f[R].
1061959Offsets are 0 by default.
1062960Implies \f[C]\-\-number\-sections\f[R].
1063−.RS
1064−.RE
1065961.TP
1066962.B \f[C]\-\-listings\f[R]
1067963Use the \f[C]listings\f[R] package for LaTeX code blocks.
@@ -1069,14 +965,10 @@ The package does not support multi\-byte encoding for source code.
1069965To handle UTF\-8 you would need to use a custom template.
1070966This issue is fully documented here: Encoding issue with the listings
1071967package.
1072−.RS
1073−.RE
1074968.TP
1075969.B \f[C]\-i\f[R], \f[C]\-\-incremental\f[R]
1076970Make list items in slide shows display incrementally (one by one).
1077971The default is for lists to be displayed all at once.
1078−.RS
1079−.RE
1080972.TP
1081973.B \f[C]\-\-slide\-level=\f[R]\f[I]NUMBER\f[R]
1082974Specifies that headers with the specified level create slides (for
@@ -1089,16 +981,12 @@ Note that content that is not contained under slide\-level headers will
1089981not appear in the slide show.
1090982The default is to set the slide level based on the contents of the
1091983document; see Structuring the slide show.
1092−.RS
1093−.RE
1094984.TP
1095985.B \f[C]\-\-section\-divs\f[R]
1096986Wrap sections in \f[C]<section>\f[R] tags (or \f[C]<div>\f[R] tags for
1097987\f[C]html4\f[R]), and attach identifiers to the enclosing
1098988\f[C]<section>\f[R] (or \f[C]<div>\f[R]) rather than the header itself.
1099989See Header identifiers, below.
1100−.RS
1101−.RE
1102990.TP
1103991.B \f[C]\-\-email\-obfuscation=none\f[R]|\f[C]javascript\f[R]|\f[C]references\f[R]
1104992Specify a method for obfuscating \f[C]mailto:\f[R] links in HTML
@@ -1108,8 +996,6 @@ documents.
1108996\f[C]references\f[R] obfuscates them by printing their letters as
1109997decimal or hexadecimal character references.
1110998The default is \f[C]none\f[R].
1111−.RS
1112−.RE
1113999.TP
11141000.B \f[C]\-\-id\-prefix=\f[R]\f[I]STRING\f[R]
11151001Specify a prefix to be added to all identifiers and internal links in
@@ -1117,16 +1003,12 @@ HTML and DocBook output, and to footnote numbers in Markdown and Haddock
11171003output.
11181004This is useful for preventing duplicate identifiers when generating
11191005fragments to be included in other pages.
1120−.RS
1121−.RE
11221006.TP
11231007.B \f[C]\-T\f[R] \f[I]STRING\f[R], \f[C]\-\-title\-prefix=\f[R]\f[I]STRING\f[R]
11241008Specify \f[I]STRING\f[R] as a prefix at the beginning of the title that
11251009appears in the HTML header (but not in the title as it appears at the
11261010beginning of the HTML body).
11271011Implies \f[C]\-\-standalone\f[R].
1128−.RS
1129−.RE
11301012.TP
11311013.B \f[C]\-c\f[R] \f[I]URL\f[R], \f[C]\-\-css=\f[R]\f[I]URL\f[R]
11321014Link to a CSS style sheet.
@@ -1228,8 +1110,6 @@ height.
12281110Note that in a Markdown source document you can also specify
12291111\f[C]cover\-image\f[R] in a YAML metadata block (see EPUB Metadata,
12301112below).
1231−.RS
1232−.RE
12331113.TP
12341114.B \f[C]\-\-epub\-metadata=\f[R]\f[I]FILE\f[R]
12351115Look in the specified XML file for metadata for the EPUB.
@@ -1309,24 +1189,18 @@ way chapters and sections are displayed to users.
13091189Some readers may be slow if the chapter files are too large, so for
13101190large documents with few level 1 headers, one might want to use a
13111191chapter level of 2 or 3.
1312−.RS
1313−.RE
13141192.TP
13151193.B \f[C]\-\-epub\-subdirectory=\f[R]\f[I]DIRNAME\f[R]
13161194Specify the subdirectory in the OCF container that is to hold the
13171195EPUB\-specific contents.
13181196The default is \f[C]EPUB\f[R].
13191197To put the EPUB contents in the top level, use an empty string.
1320−.RS
1321−.RE
13221198.TP
13231199.B \f[C]\-\-pdf\-engine=pdflatex\f[R]|\f[C]lualatex\f[R]|\f[C]xelatex\f[R]|\f[C]wkhtmltopdf\f[R]|\f[C]weasyprint\f[R]|\f[C]prince\f[R]|\f[C]context\f[R]|\f[C]pdfroff\f[R]
13241200Use the specified engine when producing PDF output.
13251201The default is \f[C]pdflatex\f[R].
13261202If the engine is not in your PATH, the full path of the engine may be
13271203specified here.
1328−.RS
1329−.RE
13301204.TP
13311205.B \f[C]\-\-pdf\-engine\-opt=\f[R]\f[I]STRING\f[R]
13321206Use the given string as a command\-line argument to the
@@ -1334,8 +1208,6 @@ Use the given string as a command\-line argument to the
13341208If used multiple times, the arguments are provided with spaces between
13351209them.
13361210Note that no check for duplicate options is done.
1337−.RS
1338−.RE
13391211.SS Citation rendering
13401212.TP
13411213.B \f[C]\-\-bibliography=\f[R]\f[I]FILE\f[R]
@@ -1349,16 +1221,12 @@ If \f[C]\-\-natbib\f[R] or \f[C]\-\-biblatex\f[R] is also supplied,
13491221\f[C]\-\-metadata\ bibliography=FILE\f[R].
13501222If you supply this argument multiple times, each \f[I]FILE\f[R] will be
13511223added to bibliography.
1352−.RS
1353−.RE
13541224.TP
13551225.B \f[C]\-\-csl=\f[R]\f[I]FILE\f[R]
13561226Set the \f[C]csl\f[R] field in the document\[aq]s metadata to
13571227\f[I]FILE\f[R], overriding any value set in the metadata.
13581228(This is equivalent to \f[C]\-\-metadata\ csl=FILE\f[R].) This option is
13591229only relevant with \f[C]pandoc\-citeproc\f[R].
1360−.RS
1361−.RE
13621230.TP
13631231.B \f[C]\-\-citation\-abbreviations=\f[R]\f[I]FILE\f[R]
13641232Set the \f[C]citation\-abbreviations\f[R] field in the document\[aq]s
@@ -1366,8 +1234,6 @@ metadata to \f[I]FILE\f[R], overriding any value set in the metadata.
13661234(This is equivalent to
13671235\f[C]\-\-metadata\ citation\-abbreviations=FILE\f[R].) This option is
13681236only relevant with \f[C]pandoc\-citeproc\f[R].
1369−.RS
1370−.RE
13711237.TP
13721238.B \f[C]\-\-natbib\f[R]
13731239Use \f[C]natbib\f[R] for citations in LaTeX output.
@@ -1375,8 +1241,6 @@ This option is not for use with the \f[C]pandoc\-citeproc\f[R] filter or
13751241with PDF output.
13761242It is intended for use in producing a LaTeX file that can be processed
13771243with \f[C]bibtex\f[R].
1378−.RS
1379−.RE
13801244.TP
13811245.B \f[C]\-\-biblatex\f[R]
13821246Use \f[C]biblatex\f[R] for citations in LaTeX output.
@@ -1384,8 +1248,6 @@ This option is not for use with the \f[C]pandoc\-citeproc\f[R] filter or
13841248with PDF output.
13851249It is intended for use in producing a LaTeX file that can be processed
13861250with \f[C]bibtex\f[R] or \f[C]biber\f[R].
1387−.RS
1388−.RE
13891251.SS Math rendering in HTML
13901252.PP
13911253The default is to render TeX math as far as possible using Unicode
@@ -1406,8 +1268,6 @@ Then the MathJax JavaScript will render it.
14061268The \f[I]URL\f[R] should point to the \f[C]MathJax.js\f[R] load script.
14071269If a \f[I]URL\f[R] is not provided, a link to the Cloudflare CDN will be
14081270inserted.
1409−.RS
1410−.RE
14111271.TP
14121272.B \f[C]\-\-mathml\f[R]
14131273Convert TeX math to MathML (in \f[C]epub3\f[R], \f[C]docbook4\f[R],
@@ -1416,8 +1276,6 @@ Convert TeX math to MathML (in \f[C]epub3\f[R], \f[C]docbook4\f[R],
14161276This is the default in \f[C]odt\f[R] output.
14171277Note that currently only Firefox and Safari (and select e\-book readers)
14181278natively support MathML.
1419−.RS
1420−.RE
14211279.TP
14221280.B \f[C]\-\-webtex\f[R][\f[C]=\f[R]\f[I]URL\f[R]]
14231281Convert TeX formulas to \f[C]<img>\f[R] tags that link to an external
@@ -1430,8 +1288,6 @@ If no URL is specified, the CodeCogs URL generating PNGs will be used
14301288Note: the \f[C]\-\-webtex\f[R] option will affect Markdown output as
14311289well as HTML, which is useful if you\[aq]re targeting a version of
14321290Markdown without native math support.
1433−.RS
1434−.RE
14351291.TP
14361292.B \f[C]\-\-katex\f[R][\f[C]=\f[R]\f[I]URL\f[R]]
14371293Use KaTeX to display embedded TeX math in HTML output.
@@ -1440,8 +1296,6 @@ That directory should contain a \f[C]katex.min.js\f[R] and a
14401296\f[C]katex.min.css\f[R] file.
14411297If a \f[I]URL\f[R] is not provided, a link to the KaTeX CDN will be
14421298inserted.
1443−.RS
1444−.RE
14451299.TP
14461300.B \f[C]\-\-gladtex\f[R]
14471301Enclose TeX math in \f[C]<eq>\f[R] tags in HTML output.
@@ -1472,8 +1326,6 @@ in the order they appear.
14721326These do not include regular pandoc options and their arguments, but do
14731327include any options appearing after a \f[C]\-\-\f[R] separator at the
14741328end of the line.
1475−.RS
1476−.RE
14771329.TP
14781330.B \f[C]\-\-ignore\-args\f[R]
14791331Ignore command\-line arguments (for use in wrapper scripts).
@@ -1588,66 +1440,44 @@ document subtitle, included in HTML, EPUB, LaTeX, ConTeXt, and Word
15881440docx; renders in LaTeX only when using a document class that supports
15891441\f[C]\[rs]subtitle\f[R], such as \f[C]beamer\f[R] or the KOMA\-Script
15901442series (\f[C]scrartcl\f[R], \f[C]scrreprt\f[R], \f[C]scrbook\f[R]).
1591−.RS
1592−.RE
15931443.TP
15941444.B \f[C]institute\f[R]
15951445author affiliations (in LaTeX and Beamer only).
15961446Can be a list, when there are multiple authors.
1597−.RS
1598−.RE
15991447.TP
16001448.B \f[C]abstract\f[R]
16011449document summary, included in LaTeX, ConTeXt, AsciiDoc, and Word docx
1602−.RS
1603−.RE
16041450.TP
16051451.B \f[C]keywords\f[R]
16061452list of keywords to be included in HTML, PDF, and AsciiDoc metadata; may
16071453be repeated as for \f[C]author\f[R], above
1608−.RS
1609−.RE
16101454.TP
16111455.B \f[C]header\-includes\f[R]
16121456contents specified by \f[C]\-H/\-\-include\-in\-header\f[R] (may have
16131457multiple values)
1614−.RS
1615−.RE
16161458.TP
16171459.B \f[C]toc\f[R]
16181460non\-null value if \f[C]\-\-toc/\-\-table\-of\-contents\f[R] was
16191461specified
1620−.RS
1621−.RE
16221462.TP
16231463.B \f[C]toc\-title\f[R]
16241464title of table of contents (works only with EPUB, opendocument, odt,
16251465docx, pptx, beamer, LaTeX)
1626−.RS
1627−.RE
16281466.TP
16291467.B \f[C]include\-before\f[R]
16301468contents specified by \f[C]\-B/\-\-include\-before\-body\f[R] (may have
16311469multiple values)
1632−.RS
1633−.RE
16341470.TP
16351471.B \f[C]include\-after\f[R]
16361472contents specified by \f[C]\-A/\-\-include\-after\-body\f[R] (may have
16371473multiple values)
1638−.RS
1639−.RE
16401474.TP
16411475.B \f[C]body\f[R]
16421476body of document
1643−.RS
1644−.RE
16451477.TP
16461478.B \f[C]meta\-json\f[R]
16471479JSON representation of all of the document\[aq]s metadata.
16481480Field values are transformed to the selected output format.
1649−.RS
1650−.RE
16511481.SS Language variables
16521482.TP
16531483.B \f[C]lang\f[R]
@@ -1691,71 +1521,47 @@ all reveal.js configuration options.
16911521.TP
16921522.B \f[C]titlegraphic\f[R]
16931523title graphic for Beamer documents
1694−.RS
1695−.RE
16961524.TP
16971525.B \f[C]logo\f[R]
16981526logo for Beamer documents
1699−.RS
1700−.RE
17011527.TP
17021528.B \f[C]slidy\-url\f[R]
17031529base URL for Slidy documents (defaults to
17041530\f[C]https://www.w3.org/Talks/Tools/Slidy2\f[R])
1705−.RS
1706−.RE
17071531.TP
17081532.B \f[C]slideous\-url\f[R]
17091533base URL for Slideous documents (defaults to \f[C]slideous\f[R])
1710−.RS
1711−.RE
17121534.TP
17131535.B \f[C]s5\-url\f[R]
17141536base URL for S5 documents (defaults to \f[C]s5/default\f[R])
1715−.RS
1716−.RE
17171537.TP
17181538.B \f[C]revealjs\-url\f[R]
17191539base URL for reveal.js documents (defaults to \f[C]reveal.js\f[R])
1720−.RS
1721−.RE
17221540.TP
17231541.B \f[C]theme\f[R], \f[C]colortheme\f[R], \f[C]fonttheme\f[R], \f[C]innertheme\f[R], \f[C]outertheme\f[R]
17241542themes for LaTeX \f[C]beamer\f[R] documents
1725−.RS
1726−.RE
17271543.TP
17281544.B \f[C]themeoptions\f[R]
17291545options for LaTeX beamer themes (a list).
1730−.RS
1731−.RE
17321546.TP
17331547.B \f[C]navigation\f[R]
17341548controls navigation symbols in \f[C]beamer\f[R] documents (default is
17351549\f[C]empty\f[R] for no navigation symbols; other valid values are
17361550\f[C]frame\f[R], \f[C]vertical\f[R], and \f[C]horizontal\f[R]).
1737−.RS
1738−.RE
17391551.TP
17401552.B \f[C]section\-titles\f[R]
17411553enables on \[dq]title pages\[dq] for new sections in \f[C]beamer\f[R]
17421554documents (default = true).
1743−.RS
1744−.RE
17451555.TP
17461556.B \f[C]beamerarticle\f[R]
17471557when true, the \f[C]beamerarticle\f[R] package is loaded (for producing
17481558an article from beamer slides).
1749−.RS
1750−.RE
17511559.TP
17521560.B \f[C]aspectratio\f[R]
17531561aspect ratio of slides (for beamer only, \f[C]1610\f[R] for 16:10,
17541562\f[C]169\f[R] for 16:9, \f[C]149\f[R] for 14:9, \f[C]141\f[R] for
175515631.41:1, \f[C]54\f[R] for 5:4, \f[C]43\f[R] for 4:3 which is the default,
17561564and \f[C]32\f[R] for 3:2).
1757−.RS
1758−.RE
17591565.SS Variables for LaTeX
17601566.PP
17611567LaTeX variables are used when creating a PDF.
@@ -1763,72 +1569,50 @@ LaTeX variables are used when creating a PDF.
17631569.B \f[C]papersize\f[R]
17641570paper size, e.g.
17651571\f[C]letter\f[R], \f[C]a4\f[R]
1766−.RS
1767−.RE
17681572.TP
17691573.B \f[C]fontsize\f[R]
17701574font size for body text (e.g.
17711575\f[C]10pt\f[R], \f[C]12pt\f[R])
1772−.RS
1773−.RE
17741576.TP
17751577.B \f[C]documentclass\f[R]
17761578document class, e.g.
17771579\f[C]article\f[R], \f[C]report\f[R], \f[C]book\f[R], \f[C]memoir\f[R]
1778−.RS
1779−.RE
17801580.TP
17811581.B \f[C]classoption\f[R]
17821582option for document class, e.g.
17831583\f[C]oneside\f[R]; may be repeated for multiple options
1784−.RS
1785−.RE
17861584.TP
17871585.B \f[C]beameroption\f[R]
17881586In beamer, add extra beamer option with \f[C]\[rs]setbeameroption{}\f[R]
1789−.RS
1790−.RE
17911587.TP
17921588.B \f[C]geometry\f[R]
17931589option for \f[C]geometry\f[R] package, e.g.
17941590\f[C]margin=1in\f[R]; may be repeated for multiple options
1795−.RS
1796−.RE
17971591.TP
17981592.B \f[C]margin\-left\f[R], \f[C]margin\-right\f[R], \f[C]margin\-top\f[R], \f[C]margin\-bottom\f[R]
17991593sets margins, if \f[C]geometry\f[R] is not used (otherwise
18001594\f[C]geometry\f[R] overrides these)
1801−.RS
1802−.RE
18031595.TP
18041596.B \f[C]linestretch\f[R]
18051597adjusts line spacing using the \f[C]setspace\f[R] package, e.g.
18061598\f[C]1.25\f[R], \f[C]1.5\f[R]
1807−.RS
1808−.RE
18091599.TP
18101600.B \f[C]fontfamily\f[R]
18111601font package for use with \f[C]pdflatex\f[R]: TeX Live includes many
18121602options, documented in the LaTeX Font Catalogue.
18131603The default is Latin Modern.
1814−.RS
1815−.RE
18161604.TP
18171605.B \f[C]fontfamilyoptions\f[R]
18181606options for package used as \f[C]fontfamily\f[R]: e.g.
18191607\f[C]osf,sc\f[R] with \f[C]fontfamily\f[R] set to \f[C]mathpazo\f[R]
18201608provides Palatino with old\-style figures and true small caps; may be
18211609repeated for multiple options
1822−.RS
1823−.RE
18241610.TP
18251611.B \f[C]mainfont\f[R], \f[C]sansfont\f[R], \f[C]monofont\f[R], \f[C]mathfont\f[R], \f[C]CJKmainfont\f[R]
18261612font families for use with \f[C]xelatex\f[R] or \f[C]lualatex\f[R]: take
18271613the name of any system font, using the \f[C]fontspec\f[R] package.
18281614Note that if \f[C]CJKmainfont\f[R] is used, the \f[C]xecjk\f[R] package
18291615must be available.
1830−.RS
1831−.RE
18321616.TP
18331617.B \f[C]mainfontoptions\f[R], \f[C]sansfontoptions\f[R], \f[C]monofontoptions\f[R], \f[C]mathfontoptions\f[R], \f[C]CJKoptions\f[R]
18341618options to use with \f[C]mainfont\f[R], \f[C]sansfont\f[R],
@@ -1837,202 +1621,136 @@ options to use with \f[C]mainfont\f[R], \f[C]sansfont\f[R],
18371621Allow for any choices available through \f[C]fontspec\f[R], such as the
18381622OpenType features \f[C]Numbers=OldStyle,Numbers=Proportional\f[R].
18391623May be repeated for multiple options.
1840−.RS
1841−.RE
18421624.TP
18431625.B \f[C]fontenc\f[R]
18441626allows font encoding to be specified through \f[C]fontenc\f[R] package
18451627(with \f[C]pdflatex\f[R]); default is \f[C]T1\f[R] (see guide to LaTeX
18461628font encodings)
1847−.RS
1848−.RE
18491629.TP
18501630.B \f[C]microtypeoptions\f[R]
18511631options to pass to the microtype package
1852−.RS
1853−.RE
18541632.TP
18551633.B \f[C]colorlinks\f[R]
18561634add color to link text; automatically enabled if any of
18571635\f[C]linkcolor\f[R], \f[C]filecolor\f[R], \f[C]citecolor\f[R],
18581636\f[C]urlcolor\f[R], or \f[C]toccolor\f[R] are set
1859−.RS
1860−.RE
18611637.TP
18621638.B \f[C]linkcolor\f[R], \f[C]filecolor\f[R], \f[C]citecolor\f[R], \f[C]urlcolor\f[R], \f[C]toccolor\f[R]
18631639color for internal links, external links, citation links, linked URLs,
18641640and links in table of contents, respectively: uses options allowed by
18651641\f[C]xcolor\f[R], including the \f[C]dvipsnames\f[R],
18661642\f[C]svgnames\f[R], and \f[C]x11names\f[R] lists
1867−.RS
1868−.RE
18691643.TP
18701644.B \f[C]links\-as\-notes\f[R]
18711645causes links to be printed as footnotes
1872−.RS
1873−.RE
18741646.TP
18751647.B \f[C]indent\f[R]
18761648uses document class settings for indentation (the default LaTeX template
18771649otherwise removes indentation and adds space between paragraphs)
1878−.RS
1879−.RE
18801650.TP
18811651.B \f[C]subparagraph\f[R]
18821652disables default behavior of LaTeX template that redefines
18831653(sub)paragraphs as sections, changing the appearance of nested headings
18841654in some classes
1885−.RS
1886−.RE
18871655.TP
18881656.B \f[C]thanks\f[R]
18891657specifies contents of acknowledgments footnote after document title.
1890−.RS
1891−.RE
18921658.TP
18931659.B \f[C]toc\f[R]
18941660include table of contents (can also be set using
18951661\f[C]\-\-toc/\-\-table\-of\-contents\f[R])
1896−.RS
1897−.RE
18981662.TP
18991663.B \f[C]toc\-depth\f[R]
19001664level of section to include in table of contents
1901−.RS
1902−.RE
19031665.TP
19041666.B \f[C]secnumdepth\f[R]
19051667numbering depth for sections, if sections are numbered
1906−.RS
1907−.RE
19081668.TP
19091669.B \f[C]lof\f[R], \f[C]lot\f[R]
19101670include list of figures, list of tables
1911−.RS
1912−.RE
19131671.TP
19141672.B \f[C]bibliography\f[R]
19151673bibliography to use for resolving references
1916−.RS
1917−.RE
19181674.TP
19191675.B \f[C]biblio\-style\f[R]
19201676bibliography style, when used with \f[C]\-\-natbib\f[R] and
19211677\f[C]\-\-biblatex\f[R].
1922−.RS
1923−.RE
19241678.TP
19251679.B \f[C]biblio\-title\f[R]
19261680bibliography title, when used with \f[C]\-\-natbib\f[R] and
19271681\f[C]\-\-biblatex\f[R].
1928−.RS
1929−.RE
19301682.TP
19311683.B \f[C]biblatexoptions\f[R]
19321684list of options for biblatex.
1933−.RS
1934−.RE
19351685.TP
19361686.B \f[C]natbiboptions\f[R]
19371687list of options for natbib.
1938−.RS
1939−.RE
19401688.TP
19411689.B \f[C]pagestyle\f[R]
19421690An option for LaTeX\[aq]s \f[C]\[rs]pagestyle{}\f[R].
19431691The default article class supports \[aq]plain\[aq] (default),
19441692\[aq]empty\[aq], and \[aq]headings\[aq]; headings puts section titles in
19451693the header.
1946−.RS
1947−.RE
19481694.SS Variables for ConTeXt
19491695.TP
19501696.B \f[C]papersize\f[R]
19511697paper size, e.g.
19521698\f[C]letter\f[R], \f[C]A4\f[R], \f[C]landscape\f[R] (see ConTeXt Paper
19531699Setup); may be repeated for multiple options
1954−.RS
1955−.RE
19561700.TP
19571701.B \f[C]layout\f[R]
19581702options for page margins and text arrangement (see ConTeXt Layout); may
19591703be repeated for multiple options
1960−.RS
1961−.RE
19621704.TP
19631705.B \f[C]margin\-left\f[R], \f[C]margin\-right\f[R], \f[C]margin\-top\f[R], \f[C]margin\-bottom\f[R]
19641706sets margins, if \f[C]layout\f[R] is not used (otherwise
19651707\f[C]layout\f[R] overrides these)
1966−.RS
1967−.RE
19681708.TP
19691709.B \f[C]fontsize\f[R]
19701710font size for body text (e.g.
19711711\f[C]10pt\f[R], \f[C]12pt\f[R])
1972−.RS
1973−.RE
19741712.TP
19751713.B \f[C]mainfont\f[R], \f[C]sansfont\f[R], \f[C]monofont\f[R], \f[C]mathfont\f[R]
19761714font families: take the name of any system font (see ConTeXt Font
19771715Switching)
1978−.RS
1979−.RE
19801716.TP
19811717.B \f[C]linkcolor\f[R], \f[C]contrastcolor\f[R]
19821718color for links outside and inside a page, e.g.
19831719\f[C]red\f[R], \f[C]blue\f[R] (see ConTeXt Color)
1984−.RS
1985−.RE
19861720.TP
19871721.B \f[C]linkstyle\f[R]
19881722typeface style for links, e.g.
19891723\f[C]normal\f[R], \f[C]bold\f[R], \f[C]slanted\f[R],
19901724\f[C]boldslanted\f[R], \f[C]type\f[R], \f[C]cap\f[R], \f[C]small\f[R]
1991−.RS
1992−.RE
19931725.TP
19941726.B \f[C]indenting\f[R]
19951727controls indentation of paragraphs, e.g.
19961728\f[C]yes,small,next\f[R] (see ConTeXt Indentation); may be repeated for
19971729multiple options
1998−.RS
1999−.RE
20001730.TP
20011731.B \f[C]whitespace\f[R]
20021732spacing between paragraphs, e.g.
20031733\f[C]none\f[R], \f[C]small\f[R] (using \f[C]setupwhitespace\f[R])
2004−.RS
2005−.RE
20061734.TP
20071735.B \f[C]interlinespace\f[R]
20081736adjusts line spacing, e.g.
20091737\f[C]4ex\f[R] (using \f[C]setupinterlinespace\f[R]); may be repeated for
20101738multiple options
2011−.RS
2012−.RE
20131739.TP
20141740.B \f[C]headertext\f[R], \f[C]footertext\f[R]
20151741text to be placed in running header or footer (see ConTeXt Headers and
20161742Footers); may be repeated up to four times for different placement
2017−.RS
2018−.RE
20191743.TP
20201744.B \f[C]pagenumbering\f[R]
20211745page number style and location (using \f[C]setuppagenumbering\f[R]); may
20221746be repeated for multiple options
2023−.RS
2024−.RE
20251747.TP
20261748.B \f[C]toc\f[R]
20271749include table of contents (can also be set using
20281750\f[C]\-\-toc/\-\-table\-of\-contents\f[R])
2029−.RS
2030−.RE
20311751.TP
20321752.B \f[C]lof\f[R], \f[C]lot\f[R]
20331753include list of figures, list of tables
2034−.RS
2035−.RE
20361754.TP
20371755.B \f[C]pdfa\f[R]
20381756adds to the preamble the setup necessary to generate PDF/A\-1b:2005.
@@ -2041,60 +1759,40 @@ be available and the content and all included files (such as images)
20411759have to be standard conforming.
20421760The ICC profiles can be obtained from ConTeXt ICC Profiles.
20431761See also ConTeXt PDFA for more details.
2044−.RS
2045−.RE
20461762.SS Variables for man pages
20471763.TP
20481764.B \f[C]section\f[R]
20491765section number in man pages
2050−.RS
2051−.RE
20521766.TP
20531767.B \f[C]header\f[R]
20541768header in man pages
2055−.RS
2056−.RE
20571769.TP
20581770.B \f[C]footer\f[R]
20591771footer in man pages
2060−.RS
2061−.RE
20621772.TP
20631773.B \f[C]adjusting\f[R]
20641774adjusts text to left (\f[C]l\f[R]), right (\f[C]r\f[R]), center
20651775(\f[C]c\f[R]), or both (\f[C]b\f[R]) margins
2066−.RS
2067−.RE
20681776.TP
20691777.B \f[C]hyphenate\f[R]
20701778if \f[C]true\f[R] (the default), hyphenation will be used
2071−.RS
2072−.RE
20731779.SS Variables for ms
20741780.TP
20751781.B \f[C]pointsize\f[R]
20761782point size (e.g.
20771783\f[C]10p\f[R])
2078−.RS
2079−.RE
20801784.TP
20811785.B \f[C]lineheight\f[R]
20821786line height (e.g.
20831787\f[C]12p\f[R])
2084−.RS
2085−.RE
20861788.TP
20871789.B \f[C]fontfamily\f[R]
20881790font family (e.g.
20891791\f[C]T\f[R] or \f[C]P\f[R])
2090−.RS
2091−.RE
20921792.TP
20931793.B \f[C]indent\f[R]
20941794paragraph indent (e.g.
20951795\f[C]2m\f[R])
2096−.RS
2097−.RE
20981796.SS Using variables in templates
20991797.PP
21001798Variable names are sequences of alphanumerics, \f[C]\-\f[R], and
@@ -2218,19 +1916,13 @@ This extension can be enabled/disabled for the following formats:
22181916.B input formats
22191917\f[C]markdown\f[R], \f[C]commonmark\f[R], \f[C]latex\f[R],
22201918\f[C]mediawiki\f[R], \f[C]org\f[R], \f[C]rst\f[R], \f[C]twiki\f[R]
2221−.RS
2222−.RE
22231919.TP
22241920.B output formats
22251921\f[C]markdown\f[R], \f[C]latex\f[R], \f[C]context\f[R], \f[C]rst\f[R]
2226−.RS
2227−.RE
22281922.TP
22291923.B enabled by default in
22301924\f[C]markdown\f[R], \f[C]latex\f[R], \f[C]context\f[R] (both input and
22311925output)
2232−.RS
2233−.RE
22341926.PP
22351927Note: If you are \f[I]writing\f[R] Markdown, then the \f[C]smart\f[R]
22361928extension has the reverse effect: what would have been curly quotes
@@ -2257,18 +1949,12 @@ This extension can be enabled/disabled for the following formats:
22571949.B input formats
22581950\f[C]markdown\f[R], \f[C]latex\f[R], \f[C]rst\f[R], \f[C]mediawiki\f[R],
22591951\f[C]textile\f[R]
2260−.RS
2261−.RE
22621952.TP
22631953.B output formats
22641954\f[C]markdown\f[R], \f[C]muse\f[R]
2265−.RS
2266−.RE
22671955.TP
22681956.B enabled by default in
22691957\f[C]markdown\f[R], \f[C]muse\f[R]
2270−.RS
2271−.RE
22721958.PP
22731959The algorithm used to derive the identifier from the header text is:
22741960.IP \[bu] 2
@@ -2392,13 +2078,9 @@ addition to \f[C]markdown\f[R]):
23922078.B input formats
23932079\f[C]latex\f[R], \f[C]org\f[R], \f[C]textile\f[R], \f[C]html\f[R]
23942080(environments, \f[C]\[rs]ref\f[R], and \f[C]\[rs]eqref\f[R] only)
2395−.RS
2396−.RE
23972081.TP
23982082.B output formats
23992083\f[C]textile\f[R], \f[C]commonmark\f[R]
2400−.RS
2401−.RE
24022084.SS Extension: \f[C]native_divs\f[R]
24032085.PP
24042086This extension is enabled by default for HTML input.
@@ -2426,13 +2108,9 @@ This extension can be enabled/disabled for the following formats:
24262108.TP
24272109.B input formats
24282110\f[C]markdown\f[R], \f[C]rst\f[R], \f[C]latex\f[R]
2429−.RS
2430−.RE
24312111.TP
24322112.B output formats
24332113\f[C]markdown\f[R], \f[C]rst\f[R], \f[C]latex\f[R], \f[C]html\f[R]
2434−.RS
2435−.RE
24362114.PP
24372115If you append \f[C]+lhs\f[R] (or \f[C]+literate_haskell\f[R]) to one of
24382116the formats above, pandoc will treat the document as literate Haskell
@@ -2504,13 +2182,9 @@ This extension can be enabled/disabled for the following formats:
25042182.TP
25052183.B input formats
25062184\f[C]docx\f[R], \f[C]html\f[R]
2507−.RS
2508−.RE
25092185.TP
25102186.B output formats
25112187\f[C]docx\f[R], \f[C]odt\f[R], \f[C]opendocument\f[R], \f[C]html\f[R]
2512−.RS
2513−.RE
25142188.SS Extension: \f[C]styles\f[R]
25152189.PP
25162190Read all docx styles as divs (for paragraph styles) and spans (for
@@ -2521,8 +2195,6 @@ Disabled by default.
25212195.TP
25222196.B input formats
25232197\f[C]docx\f[R]
2524−.RS
2525−.RE
25262198.SS Extension: \f[C]amuse\f[R]
25272199.PP
25282200In the \f[C]muse\f[R] input format, this enables Text::Amuse extensions
@@ -4136,82 +3808,54 @@ How it is rendered depends on the output format:
41363808.B LaTeX
41373809It will appear verbatim surrounded by \f[C]\[rs](...\[rs])\f[R] (for
41383810inline math) or \f[C]\[rs][...\[rs]]\f[R] (for display math).
4139−.RS
4140−.RE
41413811.TP
41423812.B Markdown, Emacs Org mode, ConTeXt, ZimWiki
41433813It will appear verbatim surrounded by \f[C]$...$\f[R] (for inline math)
41443814or \f[C]$$...$$\f[R] (for display math).
4145−.RS
4146−.RE
41473815.TP
41483816.B reStructuredText
41493817It will be rendered using an interpreted text role \f[C]:math:\f[R].
4150−.RS
4151−.RE
41523818.TP
41533819.B AsciiDoc
41543820It will be rendered as \f[C]latexmath:[...]\f[R].
4155−.RS
4156−.RE
41573821.TP
41583822.B Texinfo
41593823It will be rendered inside a \f[C]\[at]math\f[R] command.
4160−.RS
4161−.RE
41623824.TP
41633825.B groff man
41643826It will be rendered verbatim without \f[C]$\f[R]\[aq]s.
4165−.RS
4166−.RE
41673827.TP
41683828.B MediaWiki, DokuWiki
41693829It will be rendered inside \f[C]<math>\f[R] tags.
4170−.RS
4171−.RE
41723830.TP
41733831.B Textile
41743832It will be rendered inside \f[C]<span\ class=\[dq]math\[dq]>\f[R] tags.
4175−.RS
4176−.RE
41773833.TP
41783834.B RTF, OpenDocument
41793835It will be rendered, if possible, using Unicode characters, and will
41803836otherwise appear verbatim.
4181−.RS
4182−.RE
41833837.TP
41843838.B ODT
41853839It will be rendered, if possible, using MathML.
4186−.RS
4187−.RE
41883840.TP
41893841.B DocBook
41903842If the \f[C]\-\-mathml\f[R] flag is used, it will be rendered using
41913843MathML in an \f[C]inlineequation\f[R] or \f[C]informalequation\f[R] tag.
41923844Otherwise it will be rendered, if possible, using Unicode characters.
4193−.RS
4194−.RE
41953845.TP
41963846.B Docx
41973847It will be rendered using OMML math markup.
4198−.RS
4199−.RE
42003848.TP
42013849.B FictionBook2
42023850If the \f[C]\-\-webtex\f[R] option is used, formulas are rendered as
42033851images using CodeCogs or other compatible web service, downloaded and
42043852embedded in the e\-book.
42053853Otherwise, they will appear verbatim.
4206−.RS
4207−.RE
42083854.TP
42093855.B HTML, Slidy, DZSlides, S5, EPUB
42103856The way math is rendered in HTML will depend on the command\-line
42113857options selected.
42123858Therefore see Math rendering in HTML above.
4213−.RS
4214−.RE
42153859.SS Raw HTML
42163860.SS Extension: \f[C]raw_html\f[R]
42173861.PP
@@ -4887,33 +4531,21 @@ and in CSL JSON databases, an HTML\-like markup:
48874531.TP
48884532.B \f[C]<i>...</i>\f[R]
48894533italics
4890−.RS
4891−.RE
48924534.TP
48934535.B \f[C]<b>...</b>\f[R]
48944536bold
4895−.RS
4896−.RE
48974537.TP
48984538.B \f[C]<span\ style=\[dq]font\-variant:small\-caps;\[dq]>...</span>\f[R] or \f[C]<sc>...</sc>\f[R]
48994539small capitals
4900−.RS
4901−.RE
49024540.TP
49034541.B \f[C]<sub>...</sub>\f[R]
49044542subscript
4905−.RS
4906−.RE
49074543.TP
49084544.B \f[C]<sup>...</sup>\f[R]
49094545superscript
4910−.RS
4911−.RE
49124546.TP
49134547.B \f[C]<span\ class=\[dq]nocase\[dq]>...</span>\f[R]
49144548prevent a phrase from being capitalized as title case
4915−.RS
4916−.RE
49174549.PP
49184550\f[C]pandoc\-citeproc\ \-j\f[R] and \f[C]\-y\f[R] interconvert the CSL
49194551JSON and CSL YAML formats as far as possible.
@@ -5247,8 +4879,6 @@ variants are supported:
52474879\f[C]header_attributes\f[R], \f[C]link_attributes\f[R],
52484880\f[C]abbreviations\f[R], \f[C]shortcut_reference_links\f[R],
52494881\f[C]spaced_reference_links\f[R].
5250−.RS
5251−.RE
52524882.TP
52534883.B \f[C]markdown_github\f[R] (deprecated GitHub\-Flavored Markdown)
52544884\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]fenced_code_blocks\f[R],
@@ -5258,8 +4888,6 @@ variants are supported:
52584888\f[C]strikeout\f[R], \f[C]emoji\f[R],
52594889\f[C]shortcut_reference_links\f[R], \f[C]angle_brackets_escapable\f[R],
52604890\f[C]lists_without_preceding_blankline\f[R].
5261−.RS
5262−.RE
52634891.TP
52644892.B \f[C]markdown_mmd\f[R] (MultiMarkdown)
52654893\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]markdown_attribute\f[R],
@@ -5272,14 +4900,10 @@ variants are supported:
52724900\f[C]superscript\f[R], \f[C]subscript\f[R],
52734901\f[C]backtick_code_blocks\f[R], \f[C]spaced_reference_links\f[R],
52744902\f[C]raw_attribute\f[R].
5275−.RS
5276−.RE
52774903.TP
52784904.B \f[C]markdown_strict\f[R] (Markdown.pl)
52794905\f[C]raw_html\f[R], \f[C]shortcut_reference_links\f[R],
52804906\f[C]spaced_reference_links\f[R].
5281−.RS
5282−.RE
52834907.PP
52844908We also support \f[C]commonmark\f[R] and \f[C]gfm\f[R] (GitHub\-Flavored
52854909Markdown, which is implemented as a set of extensions on
@@ -5299,8 +4923,6 @@ Also, \f[C]raw_tex\f[R] only affects \f[C]gfm\f[R] output, not input.
52994923\f[C]intraword_underscores\f[R], \f[C]strikeout\f[R],
53004924\f[C]hard_line_breaks\f[R], \f[C]emoji\f[R],
53014925\f[C]shortcut_reference_links\f[R], \f[C]angle_brackets_escapable\f[R].
5302−.RS
5303−.RE
53044926.SH PRODUCING SLIDE SHOWS WITH PANDOC
53054927.PP
53064928You can use pandoc to produce an HTML + JavaScript slide presentation
@@ -5708,8 +5330,6 @@ Valid values for \f[C]scheme\f[R] are \f[C]ISBN\-10\f[R],
57085330\f[C]LCCN\f[R], \f[C]GTIN\-14\f[R], \f[C]ISBN\-13\f[R],
57095331\f[C]Legal\ deposit\ number\f[R], \f[C]URN\f[R], \f[C]OCLC\f[R],
57105332\f[C]ISMN\-13\f[R], \f[C]ISBN\-A\f[R], \f[C]JP\f[R], \f[C]OLCC\f[R].
5711−.RS
5712−.RE
57135333.TP
57145334.B \f[C]title\f[R]
57155335Either a string value, or an object with fields \f[C]file\-as\f[R] and
@@ -5717,8 +5337,6 @@ Either a string value, or an object with fields \f[C]file\-as\f[R] and
57175337Valid values for \f[C]type\f[R] are \f[C]main\f[R], \f[C]subtitle\f[R],
57185338\f[C]short\f[R], \f[C]collection\f[R], \f[C]edition\f[R],
57195339\f[C]extended\f[R].
5720−.RS
5721−.RE
57225340.TP
57235341.B \f[C]creator\f[R]
57245342Either a string value, or an object with fields \f[C]role\f[R],
@@ -5726,78 +5344,50 @@ Either a string value, or an object with fields \f[C]role\f[R],
57265344Valid values for \f[C]role\f[R] are MARC relators, but pandoc will
57275345attempt to translate the human\-readable versions (like \[dq]author\[dq]
57285346and \[dq]editor\[dq]) to the appropriate marc relators.
5729−.RS
5730−.RE
57315347.TP
57325348.B \f[C]contributor\f[R]
57335349Same format as \f[C]creator\f[R].
5734−.RS
5735−.RE
57365350.TP
57375351.B \f[C]date\f[R]
57385352A string value in \f[C]YYYY\-MM\-DD\f[R] format.
57395353(Only the year is necessary.) Pandoc will attempt to convert other
57405354common date formats.
5741−.RS
5742−.RE
57435355.TP
57445356.B \f[C]lang\f[R] (or legacy: \f[C]language\f[R])
57455357A string value in BCP 47 format.
57465358Pandoc will default to the local language if nothing is specified.
5747−.RS
5748−.RE
57495359.TP
57505360.B \f[C]subject\f[R]
57515361A string value or a list of such values.
5752−.RS
5753−.RE
57545362.TP
57555363.B \f[C]description\f[R]
57565364A string value.
5757−.RS
5758−.RE
57595365.TP
57605366.B \f[C]type\f[R]
57615367A string value.
5762−.RS
5763−.RE
57645368.TP
57655369.B \f[C]format\f[R]
57665370A string value.
5767−.RS
5768−.RE
57695371.TP
57705372.B \f[C]relation\f[R]
57715373A string value.
5772−.RS
5773−.RE
57745374.TP
57755375.B \f[C]coverage\f[R]
57765376A string value.
5777−.RS
5778−.RE
57795377.TP
57805378.B \f[C]rights\f[R]
57815379A string value.
5782−.RS
5783−.RE
57845380.TP
57855381.B \f[C]cover\-image\f[R]
57865382A string value (path to cover image).
5787−.RS
5788−.RE
57895383.TP
57905384.B \f[C]stylesheet\f[R]
57915385A string value (path to CSS stylesheet).
5792−.RS
5793−.RE
57945386.TP
57955387.B \f[C]page\-progression\-direction\f[R]
57965388Either \f[C]ltr\f[R] or \f[C]rtl\f[R].
57975389Specifies the \f[C]page\-progression\-direction\f[R] attribute for the
57985390\f[C]spine\f[R] element.
5799−.RS
5800−.RE
58015391.TP
58025392.B \f[C]ibooks\f[R]
58035393iBooks\-specific metadata, with the following fields: