Bug#1084772: pandoc.1: Some remarks and editorial changes for this man page
Package: pandoc
Version: 3.1.3+ds-3+b1
Severity: minor
Tags: patch
* What led up to the situation?
Checking for defects with
[test-][g|n]roff -mandoc -t -K utf8 -rF0 -rHY=0 -ww -b -z < "man page"
[test-groff is a script in the repository for "groff"] (local copy and
"troff" slightly changed by me).
* What was the outcome of this action?
A lot of warnings, see appended files.
* What outcome did you expect instead?
No output (no warnings).
-.-
General remarks and further material, if a diff-file exist, are in the
attachments.
-- System Information:
Debian Release: trixie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 6.10.11-amd64 (SMP w/2 CPU threads; PREEMPT)
Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: sysvinit (via /sbin/init)
Versions of packages pandoc depends on:
ii libc6 2.40-2
ii libffi8 3.4.6-1
ii libgmp10 2:6.3.0+dfsg-2+b1
ii liblua5.4-0 5.4.6-3+b1
ii libyaml-0-2 0.2.5-1+b1
ii pandoc-data 3.1.3-3
ii zlib1g 1:1.3.dfsg+really1.3.1-1
pandoc recommends no packages.
Versions of packages pandoc suggests:
pn citation-style-language-styles <none>
pn context <none>
pn ghc <none>
ii groff 1.23.0-5
pn libjs-katex <none>
ii libjs-mathjax 2.7.9+dfsg-1
pn librsvg2-bin <none>
pn nodejs <none>
pn pandoc-citeproc <none>
ii perl 5.38.2-5
pn php <none>
pn python <none>
pn r-base-core <none>
ii ruby 1:3.1+nmu1
pn texlive-latex-extra <none>
ii texlive-latex-recommended 2024.20240829-2
pn texlive-luatex <none>
pn texlive-xetex <none>
pn wkhtmltopdf <none>
-- no debconf information
Any program (person), that produces man pages, should check its content for
defects by using
groff -mandoc -t -ww -b -z [ -K utf8 | k ] <man page>
The same goes for man pages that are used as an input.
For a style guide use
mandoc -T lint
-.-
So any 'generator' should check its products with the above mentioned
'groff', 'mandoc', and additionally with 'nroff ...'.
This is just a simple quality control measure.
The 'generator' may have to be corrected to get a better man page,
the source file may, and any additional file may.
Common defects:
Input text line longer than 80 bytes.
Not removing trailing spaces (in in- and output).
The reason for these trailing spaces should be found and eliminated.
Not beginning each input sentence on a new line.
Lines should thus be shorter.
See man-pages(7), item 'semantic newline'.
-.-
The difference between the formatted outputs can be seen with:
nroff -mandoc <file1> > <out1>
nroff -mandoc <file2> > <out2>
diff -u <out1> <out2>
and for groff, using
"printf '%s\n%s\n' '.kern 0' '.ss 12 0' | groff -mandoc -Z - "
instead of \'nroff -mandoc\'
Add the option \'-t\', if the file contains a table.
Read the output of \'diff -u\' with \'less -R\' or similar.
-.-.
If \'man\' (man-db) is used to check the manual for warnings,
the following must be set:
The option "-warnings=w"
The environmental variable:
export MAN_KEEP_STDERR=yes (or any non-empty value)
or
(produce only warnings):
export MANROFFOPT="-ww -b -z"
export MAN_KEEP_STDERR=yes (or any non-empty value)
-.-.
Output from "mandoc -T lint pandoc.1": (possibly shortened list)
mandoc: pandoc.1:22:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:25:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:60:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:90:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:136:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:152:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:215:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:1584:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:1683:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:1726:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:2138:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:2190:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2194:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2207:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2247:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2300:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2357:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2429:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2475:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2488:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2795:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2823:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2858:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:2865:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3096:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3116:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3212:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3285:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3362:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:3385:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3420:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3506:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3512:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3520:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3530:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3575:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3646:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3658:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3667:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3684:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3704:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3714:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3718:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3725:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3736:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3747:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3753:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3759:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3767:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:3780:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3802:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3810:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3815:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3818:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3836:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3858:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3874:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3880:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3883:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:3943:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4007:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4062:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4081:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4101:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4135:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4139:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4231:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4269:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4322:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4392:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4419:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4442:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4484:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4496:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4565:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4606:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4655:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4673:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4680:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4687:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4740:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4801:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4903:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:4970:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5090:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5254:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5312:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5340:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5353:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5365:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5387:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5420:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5430:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5450:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5477:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5498:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5579:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5601:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5649:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5656:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5663:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5699:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5753:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5781:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5784:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5795:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5821:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5902:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5914:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5938:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5953:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:5983:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6051:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6058:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6111:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6123:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6159:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6175:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6310:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6317:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6354:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6365:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6399:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6406:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6411:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6415:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6419:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6429:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6433:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6440:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6447:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6450:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6457:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6463:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6470:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6488:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6501:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6505:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6520:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6525:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6540:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6545:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6551:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6571:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6592:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6627:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:6647:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6768:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6831:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6852:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6884:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6920:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:6969:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7009:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7064:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:7158:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7206:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7247:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7311:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7329:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7371:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7397:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7415:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7460:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7498:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7502:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7513:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7527:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7543:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7576:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7715:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7772:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7801:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:7815:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:7834:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:7962:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:8008:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:8011:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:8067:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:8121:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:8169:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:8183:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:8208:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:8228:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:8243:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:8257:2: WARNING: skipping paragraph macro: PP after SS
mandoc: pandoc.1:8266:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:8281:2: WARNING: skipping paragraph macro: PP after SH
mandoc: pandoc.1:8342:2: WARNING: skipping paragraph macro: PP after SH
-.-.
Remove space characters at the end of lines.
Use "git apply ... --whitespace=fix" to fix extra space issues, or use
global configuration "core.whitespace".
1796: command line defaults file
1798: foo.md input-file: foo.md
1800: foo.md bar.md input-files:
1801: - foo.md
1802: - bar.md
1816: command line defaults file
1818: --from markdown+emoji from: markdown+emoji
1819:
1820: reader: markdown+emoji
1822: to: markdown+hard_line_breaks
1823: --to markdown+hard_line_breaks
1824:
1825: writer: markdown+hard_line_breaks
1827: --output foo.pdf output-file: foo.pdf
1829: --output - output-file:
1831: --data-dir dir data-dir: dir
1833: --defaults file defaults:
1834: - file
1836: --verbose verbosity: INFO
1838: --quiet verbosity: ERROR
1840: --fail-if-warnings fail-if-warnings: true
1842: --sandbox sandbox: true
1844: --log=FILE log-file: FILE
1861: command line defaults file
1863: --shift-heading-level-by -1 shift-heading-level-by: -1
1865: indented-code-classes:
1866: --indented-code-classes python - python
1868:
1869: --default-image-extension \[dq].jpg\[dq] default-image-extension: \[aq].jpg\[aq]
1871: --file-scope file-scope: true
1873: --filter pandoc-citeproc \[rs] filters:
1874: - pandoc-citeproc
1875: --lua-filter count-words.lua \[rs] - count-words.lua
1876: --filter special.lua - type: json
1877: path: special.lua
1879: --metadata key=value \[rs] metadata:
1880: --metadata key2 key: value
1881: key2: true
1883: --metadata-file meta.yaml metadata-files:
1884: - meta.yaml
1885:
1886: metadata-file: meta.yaml
1888: --preserve-tabs preserve-tabs: true
1890: --tab-stop 8 tab-stop: 8
1892: --track-changes accept track-changes: accept
1894: --extract-media dir extract-media: dir
1896: --abbreviations abbrevs.txt abbreviations: abbrevs.txt
1898: --trace trace: true
1919: command line defaults file
1921: --standalone standalone: true
1923: --template letter template: letter
1925: --variable key=val \[rs] variables:
1926: --variable key2 key: val
1927: key2: true
1929: --eol nl eol: nl
1931: --dpi 300 dpi: 300
1933: --wrap 60 wrap: 60
1935: --columns 72 columns: 72
1937: --table-of-contents table-of-contents: true
1939: --toc toc: true
1941: --toc-depth 3 toc-depth: 3
1943: --strip-comments strip-comments: true
1945: --no-highlight highlight-style: null
1947: --highlight-style kate highlight-style: kate
1949: syntax-definitions:
1950: --syntax-definition mylang.xml - mylang.xml
1951:
1952: syntax-definition: mylang.xml
1954: --include-in-header inc.tex include-in-header:
1955: - inc.tex
1957: include-before-body:
1958:--include-before-body inc.tex - inc.tex
1960: --include-after-body inc.tex include-after-body:
1961: - inc.tex
1963: --resource-path .:foo resource-path: [\[aq].\[aq],\[aq]foo\[aq]]
1965: --request-header foo:bar request-headers:
1966:
1967: - [\[dq]User-Agent\[dq], \[dq]Mozilla/5.0\[dq]]
1969: --no-check-certificate no-check-certificate: true
1980: command line defaults file
1982: --self-contained self-contained: true
1984: --html-q-tags html-q-tags: true
1986: --ascii ascii: true
1988: --reference-links reference-links: true
1990: --reference-location block reference-location: block
1992: --markdown-headings atx markdown-headings: atx
1994: --list-tables list-tables: true
1996: --top-level-division chapter top-level-division: chapter
1998: --number-sections number-sections: true
2000: --number-offset=1,4 number-offset: \[rs][1,4\[rs]]
2002: --listings listings: true
2004: --incremental incremental: true
2006: --slide-level 2 slide-level: 2
2008: --section-divs section-divs: true
2010: email-obfuscation: references
2011: --email-obfuscation references
2013: --id-prefix ch1 identifier-prefix: ch1
2015: --title-prefix MySite title-prefix: MySite
2017: --css styles/screen.css \[rs] css:
2018: --css styles/special.css - styles/screen.css
2019: - styles/special.css
2021: --reference-doc my.docx reference-doc: my.docx
2023: --epub-cover-image cover.jpg epub-cover-image: cover.jpg
2025: --epub-title-page=false epub-title-page: false
2027: --epub-metadata meta.xml epub-metadata: meta.xml
2029: epub-fonts:
2030: --epub-embed-font special.otf \[rs] - special.otf
2031: - headline.otf
2032: --epub-embed-font headline.otf
2034: --split-level 2 split-level: 2
2036: --chunk-template=\[dq]%i.html\[dq] chunk-template: \[dq]%i.html\[dq]
2038: --epub-subdirectory=\[dq]\[dq] epub-subdirectory: \[aq]\[aq]
2040: --ipynb-output best ipynb-output: best
2042: --pdf-engine xelatex pdf-engine: xelatex
2044: pdf-engine-opts:
2045: --pdf-engine-opt=--shell-escape - \[aq]-shell-escape\[aq]
2046:
2047:
2048: pdf-engine-opt: \[aq]-shell-escape\[aq]
2059: command line defaults file
2061: --citeproc citeproc: true
2063: --bibliography logic.bib metadata:
2064: bibliography: logic.bib
2066: --csl ieee.csl metadata:
2067: csl: ieee.csl
2069: metadata:
2070: --citation-abbreviations ab.json
2071: citation-abbreviations: ab.json
2073: --natbib cite-method: natbib
2075: --biblatex cite-method: biblatex
2096: command line defaults file
2098: --mathjax html-math-method:
2099: method: mathjax
2101: --mathml html-math-method:
2102: method: mathml
2104: --webtex html-math-method:
2105: method: webtex
2107: --katex html-math-method:
2108: method: katex
2110: --gladtex html-math-method:
2111: method: gladtex
2128: command line defaults file
2130: --dump-args dump-args: true
2132: --ignore-args ignore-args: true
-.-.
Change '-' (\-) to '\(en' (en-dash) for a numeric range.
GNU gnulib has recently (2023-06-18) updated its
"build_aux/update-copyright" to recognize "\(en" in man pages.
pandoc.1:1140:Valid values are 0-6.
pandoc.1:3194:left unspecified, \f[V]sRGB IEC61966-2.1\f[R] is used as default.
pandoc.1:4834:| 1961-1990 | mean | 14 °C |
pandoc.1:4846:| Location | Temperature 1961-1990 |
pandoc.1:6230:Blah blah [see \[at]doe99, pp. 33-35 and *passim*; \[at]smith04, chap. 1].
pandoc.1:6235:\f[V]pp. 33-35\f[R], and suffix \f[V]and *passim*\f[R].
pandoc.1:6725: page: 737-738
-.-.
Change two HYPHEN-MINUSES (code 0x2D) to an em-dash (\(em),
if one is intended. An en-dash is usually surrounded by a space,
while an em-dash is used without spaces.
"man" (1 byte characters in input) transforms an en-dash (\(en) to one
HYPHEN-MINUS,
and an em-dash to two HYPHEN-MINUSES without considering the space
around it.
If "--" are two single "-" (end of options) then use "\-\-".
pandoc.1:32:For the full lists of input and output formats, see the \f[V]--from\f[R]
pandoc.1:33:and \f[V]--to\f[R] options below.
pandoc.1:75:\f[V]--standalone\f[R] flag:
pandoc.1:88:(Use \f[V]--file-scope\f[R] to parse files individually.)
pandoc.1:93:The input format can be specified using the \f[V]-f/--from\f[R] option,
pandoc.1:94:the output format using the \f[V]-t/--to\f[R] option.
pandoc.1:114:You can also use \f[V]pandoc --list-input-formats\f[R] and
pandoc.1:115:\f[V]pandoc --list-output-formats\f[R] to print lists of supported
pandoc.1:150:the \f[V]-s/--standalone\f[R] option.
pandoc.1:163:a LaTeX engine be installed (see \f[V]--pdf-engine\f[R] below).
pandoc.1:167:before, but add the \f[V]--pdf-engine\f[R] option or
pandoc.1:171:specified using \f[V]--pdf-engine\f[R].
pandoc.1:177:using \f[V]--css\f[R].
pandoc.1:187:\f[V]iftex\f[R], \f[V]listings\f[R] (if the \f[V]--listings\f[R] option
pandoc.1:230:pandoc -f html -t markdown --request-header User-Agent:\[dq]Mozilla/5.0\[dq] \[rs]
pandoc.1:237:\f[V]-f\f[R] \f[I]FORMAT\f[R], \f[V]-r\f[R] \f[I]FORMAT\f[R], \f[V]--from=\f[R]\f[I]FORMAT\f[R], \f[V]--read=\f[R]\f[I]FORMAT\f[R]
pandoc.1:333:See \f[V]--list-input-formats\f[R] and \f[V]--list-extensions\f[R],
pandoc.1:337:\f[V]-t\f[R] \f[I]FORMAT\f[R], \f[V]-w\f[R] \f[I]FORMAT\f[R], \f[V]--to=\f[R]\f[I]FORMAT\f[R], \f[V]--write=\f[R]\f[I]FORMAT\f[R]
pandoc.1:472:See \f[V]--list-output-formats\f[R] and \f[V]--list-extensions\f[R],
pandoc.1:476:\f[V]-o\f[R] \f[I]FILE\f[R], \f[V]--output=\f[R]\f[I]FILE\f[R]
pandoc.1:487:\f[V]--data-dir=\f[R]\f[I]DIRECTORY\f[R]
pandoc.1:500:at the output of \f[V]pandoc --version\f[R].
pandoc.1:507:\f[V]-d\f[R] \f[I]FILE\f[R], \f[V]--defaults=\f[R]\f[I]FILE\f[R]
pandoc.1:515:\f[V]--data-dir\f[R]).
pandoc.1:521:\f[V]--bash-completion\f[R]
pandoc.1:529:eval \[dq]$(pandoc --bash-completion)\[dq]
pandoc.1:534:\f[V]--verbose\f[R]
pandoc.1:537:\f[V]--quiet\f[R]
pandoc.1:540:\f[V]--fail-if-warnings\f[R]
pandoc.1:543:\f[V]--log=\f[R]\f[I]FILE\f[R]
pandoc.1:546:settings (\f[V]--verbose\f[R], \f[V]--quiet\f[R]).
pandoc.1:548:\f[V]--list-input-formats\f[R]
pandoc.1:551:\f[V]--list-output-formats\f[R]
pandoc.1:554:\f[V]--list-extensions\f[R][\f[V]=\f[R]\f[I]FORMAT\f[R]]
pandoc.1:561:\f[V]--list-highlight-languages\f[R]
pandoc.1:564:\f[V]--list-highlight-styles\f[R]
pandoc.1:566:See \f[V]--highlight-style\f[R].
pandoc.1:568:\f[V]-v\f[R], \f[V]--version\f[R]
pandoc.1:571:\f[V]-h\f[R], \f[V]--help\f[R]
pandoc.1:575:\f[V]--shift-heading-level-by=\f[R]\f[I]NUMBER\f[R]
pandoc.1:577:For example, with \f[V]--shift-heading-level-by=-1\f[R], level 2
pandoc.1:584:\f[V]--shift-heading-level-by=-1\f[R] is a good choice when converting
pandoc.1:587:\f[V]--shift-heading-level-by=1\f[R] may be a good choice for converting
pandoc.1:591:\f[V]--base-header-level=\f[R]\f[I]NUMBER\f[R]
pandoc.1:593:Use \f[VI]--shift-heading-level-by\f[I]=X instead, where X = NUMBER -
pandoc.1:596:\f[V]--indented-code-classes=\f[R]\f[I]CLASSES\f[R]
pandoc.1:601:\f[V]--default-image-extension=\f[R]\f[I]EXTENSION\f[R]
pandoc.1:608:\f[V]--file-scope\f[R]
pandoc.1:613:Reading binary files (docx, odt, epub) implies \f[V]--file-scope\f[R].
pandoc.1:616:If two or more files are processed using \f[V]--file-scope\f[R],
pandoc.1:628:\f[V]-F\f[R] \f[I]PROGRAM\f[R], \f[V]--filter=\f[R]\f[I]PROGRAM\f[R]
pandoc.1:640:pandoc --filter ./caps.py -t latex
pandoc.1:667:\f[V]$DATADIR\f[R] is the user data directory (see \f[V]--data-dir\f[R],
pandoc.1:676:\f[V]-L\f[R] \f[I]SCRIPT\f[R], \f[V]--lua-filter=\f[R]\f[I]SCRIPT\f[R]
pandoc.1:678:\f[V]--filter\f[R]), but use pandoc\[cq]s built-in Lua filtering system.
pandoc.1:697:directory (see \f[V]--data-dir\f[R], above).
pandoc.1:703:\f[V]-M\f[R] \f[I]KEY\f[R][\f[V]=\f[R]\f[I]VAL\f[R]], \f[V]--metadata=\f[R]\f[I]KEY\f[R][\f[V]:\f[R]\f[I]VAL\f[R]]
pandoc.1:709:Like \f[V]--variable\f[R], \f[V]--metadata\f[R] causes template
pandoc.1:711:But unlike \f[V]--variable\f[R], \f[V]--metadata\f[R] affects the
pandoc.1:716:\f[V]--metadata-file=\f[R]\f[I]FILE\f[R]
pandoc.1:730:\f[V]--data-dir\f[R]).
pandoc.1:732:\f[V]-p\f[R], \f[V]--preserve-tabs\f[R]
pandoc.1:739:\f[V]--tab-stop=\f[R]\f[I]NUMBER\f[R]
pandoc.1:742:\f[V]--track-changes=accept\f[R]|\f[V]reject\f[R]|\f[V]all\f[R]
pandoc.1:762:\f[V]--extract-media=\f[R]\f[I]DIR\f[R]
pandoc.1:773:\f[V]--abbreviations=\f[R]\f[I]FILE\f[R]
pandoc.1:779:\f[V]pandoc --print-default-data-file=abbreviations\f[R].
pandoc.1:785:\f[V]--trace\f[R]
pandoc.1:791:\f[V]-s\f[R], \f[V]--standalone\f[R]
pandoc.1:800:\f[V]--template=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
pandoc.1:802:Implies \f[V]--standalone\f[R].
pandoc.1:805:will be added, so that \f[V]--template=special\f[R] looks for
pandoc.1:809:\f[V]--data-dir\f[R]).
pandoc.1:811:output format will be used (see \f[V]-D/--print-default-template\f[R]).
pandoc.1:813:\f[V]-V\f[R] \f[I]KEY\f[R][\f[V]=\f[R]\f[I]VAL\f[R]], \f[V]--variable=\f[R]\f[I]KEY\f[R][\f[V]:\f[R]\f[I]VAL\f[R]]
pandoc.1:819:\f[V]--sandbox\f[R]
pandoc.1:832:find them when run in \f[V]--sandbox\f[R] mode and will raise an error.
pandoc.1:838:\f[V]-D\f[R] \f[I]FORMAT\f[R], \f[V]--print-default-template=\f[R]\f[I]FORMAT\f[R]
pandoc.1:842:This option may be used with \f[V]-o\f[R]/\f[V]--output\f[R] to redirect
pandoc.1:843:output to a file, but \f[V]-o\f[R]/\f[V]--output\f[R] must come before
pandoc.1:844:\f[V]--print-default-template\f[R] on the command line.
pandoc.1:849:To print the partials, use \f[V]--print-default-data-file\f[R]: for
pandoc.1:850:example, \f[V]--print-default-data-file=templates/styles.html\f[R].
pandoc.1:853:\f[V]--print-default-data-file=\f[R]\f[I]FILE\f[R]
pandoc.1:856:This option may be used with \f[V]-o\f[R]/\f[V]--output\f[R] to redirect
pandoc.1:857:output to a file, but \f[V]-o\f[R]/\f[V]--output\f[R] must come before
pandoc.1:858:\f[V]--print-default-data-file\f[R] on the command line.
pandoc.1:860:\f[V]--eol=crlf\f[R]|\f[V]lf\f[R]|\f[V]native\f[R]
pandoc.1:866:\f[V]--dpi\f[R]=\f[I]NUMBER\f[R]
pandoc.1:874:\f[V]--wrap=auto\f[R]|\f[V]none\f[R]|\f[V]preserve\f[R]
pandoc.1:878:the column width specified by \f[V]--columns\f[R] (default 72).
pandoc.1:887:\f[V]--columns=\f[R]\f[I]NUMBER\f[R]
pandoc.1:890:\f[V]--wrap\f[R]).
pandoc.1:894:\f[V]--toc\f[R], \f[V]--table-of-contents\f[R]
pandoc.1:899:This option has no effect unless \f[V]-s/--standalone\f[R] is used, and
pandoc.1:907:\f[V]--pdf-engine-opt=--no-toc-relocation\f[R].
pandoc.1:910:\f[V]--toc-depth=\f[R]\f[I]NUMBER\f[R]
pandoc.1:916:\f[V]--strip-comments\f[R]
pandoc.1:922:\f[V]--no-highlight\f[R]
pandoc.1:926:\f[V]--highlight-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
pandoc.1:933:See also \f[V]--list-highlight-styles\f[R].
pandoc.1:942:\f[V]--print-highlight-style\f[R].
pandoc.1:945:\f[V]--print-highlight-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
pandoc.1:948:\f[V]--highlight-style\f[R].
pandoc.1:949:This option may be used with \f[V]-o\f[R]/\f[V]--output\f[R] to redirect
pandoc.1:950:output to a file, but \f[V]-o\f[R]/\f[V]--output\f[R] must come before
pandoc.1:951:\f[V]--print-highlight-style\f[R] on the command line.
pandoc.1:953:\f[V]--syntax-definition=\f[R]\f[I]FILE\f[R]
pandoc.1:960:\f[V]-H\f[R] \f[I]FILE\f[R], \f[V]--include-in-header=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
pandoc.1:967:Implies \f[V]--standalone\f[R].
pandoc.1:969:\f[V]-B\f[R] \f[I]FILE\f[R], \f[V]--include-before-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
pandoc.1:977:Implies \f[V]--standalone\f[R].
pandoc.1:979:\f[V]-A\f[R] \f[I]FILE\f[R], \f[V]--include-after-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
pandoc.1:985:Implies \f[V]--standalone\f[R].
pandoc.1:987:\f[V]--resource-path=\f[R]\f[I]SEARCHPATH\f[R]
pandoc.1:991:If \f[V]--resource-path\f[R] is not specified, the default resource path
pandoc.1:993:Note that, if \f[V]--resource-path\f[R] is specified, the working
pandoc.1:995:For example: \f[V]--resource-path=.:test\f[R] will search the working
pandoc.1:1000:\f[V]--resource-path foo:bar --resource-path baz:bim\f[R] is equivalent
pandoc.1:1001:to \f[V]--resource-path baz:bim:foo:bar\f[R].
pandoc.1:1003:\f[V]--request-header=\f[R]\f[I]NAME\f[R]\f[V]:\f[R]\f[I]VAL\f[R]
pandoc.1:1010:\f[V]--no-check-certificate\f[R]
pandoc.1:1016:\f[V]--self-contained\f[R]
pandoc.1:1018:\f[VI]--embed-resources --standalone\f[I].\f[R]
pandoc.1:1020:\f[V]--embed-resources\f[R]
pandoc.1:1040:\f[V]--mathjax\f[R] is used, and some advanced features (e.g.\ zoom or
pandoc.1:1044:\f[V]--html-q-tags\f[R]
pandoc.1:1049:\f[V]--ascii\f[R]
pandoc.1:1057:\f[V]--reference-links\f[R]
pandoc.1:1062:\f[V]--reference-location\f[R] option.
pandoc.1:1064:\f[V]--reference-location=block\f[R]|\f[V]section\f[R]|\f[V]document\f[R]
pandoc.1:1073:In slide formats, specifying \f[V]--reference-location=section\f[R] will
pandoc.1:1076:\f[V]--markdown-headings=setext\f[R]|\f[V]atx\f[R]
pandoc.1:1083:\f[V]--list-tables\f[R]
pandoc.1:1086:\f[V]--top-level-division=default\f[R]|\f[V]section\f[R]|\f[V]chapter\f[R]|\f[V]part\f[R]
pandoc.1:1102:\f[V]-N\f[R], \f[V]--number-sections\f[R]
pandoc.1:1107:\f[V]--number-sections\f[R] is specified.
pandoc.1:1109:\f[V]--number-offset=\f[R]\f[I]NUMBER\f[R][\f[V],\f[R]\f[I]NUMBER\f[R]\f[V],\f[R]\f[I]\&...\f[R]]
pandoc.1:1116:\f[V]--number-offset=5\f[R].
pandoc.1:1118:numbered \[lq]1.5\[rq], specify \f[V]--number-offset=1,4\f[R].
pandoc.1:1120:Implies \f[V]--number-sections\f[R].
pandoc.1:1122:\f[V]--listings\f[R]
pandoc.1:1129:\f[V]-i\f[R], \f[V]--incremental\f[R]
pandoc.1:1133:\f[V]--slide-level=\f[R]\f[I]NUMBER\f[R]
pandoc.1:1148:\f[V]--section-divs\f[R]
pandoc.1:1154:\f[V]--email-obfuscation=none\f[R]|\f[V]javascript\f[R]|\f[V]references\f[R]
pandoc.1:1163:\f[V]--id-prefix=\f[R]\f[I]STRING\f[R]
pandoc.1:1170:\f[V]-T\f[R] \f[I]STRING\f[R], \f[V]--title-prefix=\f[R]\f[I]STRING\f[R]
pandoc.1:1174:Implies \f[V]--standalone\f[R].
pandoc.1:1176:\f[V]-c\f[R] \f[I]URL\f[R], \f[V]--css=\f[R]\f[I]URL\f[R]
pandoc.1:1182:It should be used together with \f[V]-s/--standalone\f[R], because the
pandoc.1:1190:\f[V]--data-dir\f[R]).
pandoc.1:1194:\f[V]--reference-doc=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
pandoc.1:1207:\f[V]--data-dir\f[R]).
pandoc.1:1213:\f[V]pandoc -o custom-reference.docx --print-default-data-file reference.docx\f[R].
pandoc.1:1309:\f[V]--data-dir\f[R]).
pandoc.1:1315:\f[V]pandoc -o custom-reference.odt --print-default-data-file reference.odt\f[R].
pandoc.1:1355:\f[V]pandoc -o custom-reference.pptx --print-default-data-file reference.pptx\f[R],
pandoc.1:1361:\f[V]--split-level=\f[R]\f[I]NUMBER\f[R]
pandoc.1:1373:\f[V]--chunk-template=\f[R]\f[I]PATHTEMPLATE\f[R]
pandoc.1:1386:\f[V]--epub-chapter-level=\f[R]\f[I]NUMBER\f[R]
pandoc.1:1387:\f[I]Deprecated synonym for \f[VI]--split-level\f[I].\f[R]
pandoc.1:1389:\f[V]--epub-cover-image=\f[R]\f[I]FILE\f[R]
pandoc.1:1397:\f[V]--epub-title-page=true\f[R]|\f[V]false\f[R]
pandoc.1:1401:\f[V]--epub-metadata=\f[R]\f[I]FILE\f[R]
pandoc.1:1428:\f[V]--epub-embed-font=\f[R]\f[I]FILE\f[R]
pandoc.1:1436:following to your CSS (see \f[V]--css\f[R]):
pandoc.1:1470:\f[V]--epub-subdirectory=\f[R]\f[I]DIRNAME\f[R]
pandoc.1:1476:\f[V]--ipynb-output=all|none|best\f[R]
pandoc.1:1485:\f[V]--pdf-engine=\f[R]\f[I]PROGRAM\f[R]
pandoc.1:1495:depending on the output format specified using \f[V]-t/--to\f[R]:
pandoc.1:1513:\f[V]--pdf-engine-opt=\f[R]\f[I]STRING\f[R]
pandoc.1:1518:\f[V]--pdf-engine-opt=-outdir=foo\f[R].
pandoc.1:1522:\f[V]-C\f[R], \f[V]--citeproc\f[R]
pandoc.1:1527:\f[V]--bibliography\f[R] option or the \f[V]bibliography\f[R] field in
pandoc.1:1531:\f[V]--csl\f[R] option or the \f[V]csl\f[R] field in metadata.
pandoc.1:1535:filters or Lua filters (see \f[V]--filter\f[R], \f[V]--lua-filter\f[R]):
pandoc.1:1540:\f[V]--bibliography=\f[R]\f[I]FILE\f[R]
pandoc.1:1547:will be sought in the resource path (see \f[V]--resource-path\f[R]).
pandoc.1:1549:\f[V]--csl=\f[R]\f[I]FILE\f[R]
pandoc.1:1552:(This is equivalent to \f[V]--metadata csl=FILE\f[R].)
pandoc.1:1555:will be sought in the resource path (see \f[V]--resource-path\f[R]) and
pandoc.1:1559:\f[V]--citation-abbreviations=\f[R]\f[I]FILE\f[R]
pandoc.1:1563:\f[V]--metadata citation-abbreviations=FILE\f[R].)
pandoc.1:1566:will be sought in the resource path (see \f[V]--resource-path\f[R]) and
pandoc.1:1570:\f[V]--natbib\f[R]
pandoc.1:1572:This option is not for use with the \f[V]--citeproc\f[R] option or with
pandoc.1:1577:\f[V]--biblatex\f[R]
pandoc.1:1579:This option is not for use with the \f[V]--citeproc\f[R] option or with
pandoc.1:1591:will want to use \f[V]--mathjax\f[R] or another of the following
pandoc.1:1594:\f[V]--mathjax\f[R][\f[V]=\f[R]\f[I]URL\f[R]]
pandoc.1:1604:\f[V]--mathml\f[R]
pandoc.1:1612:\f[V]--webtex\f[R][\f[V]=\f[R]\f[I]URL\f[R]]
pandoc.1:1617:\f[V]--webtex https://latex.codecogs.com/svg.latex?\f[R].
pandoc.1:1620:Note: the \f[V]--webtex\f[R] option will affect Markdown output as well
pandoc.1:1624:\f[V]--katex\f[R][\f[V]=\f[R]\f[I]URL\f[R]]
pandoc.1:1632:\f[V]--gladtex\f[R]
pandoc.1:1641:pandoc -s --gladtex input.md -o myfile.htex
pandoc.1:1649:\f[V]--dump-args\f[R]
pandoc.1:1659:include any options appearing after a \f[V]--\f[R] separator at the end
pandoc.1:1662:\f[V]--ignore-args\f[R]
pandoc.1:1670:pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1
pandoc.1:1691: ------ -------------------------------------
pandoc.1:1727:The \f[V]--defaults\f[R] option may be used to specify a package of
pandoc.1:1776:from any directory using \f[V]pandoc --defaults letter\f[R] or
pandoc.1:1782:(\f[V]--metadata-file\f[R], \f[V]--css\f[R],
pandoc.1:1783:\f[V]--include-in-header\f[R], \f[V]--include-before-body\f[R],
pandoc.1:1784:\f[V]--include-after-body\f[R], \f[V]--variable\f[R],
pandoc.1:1785:\f[V]--metadata\f[R], \f[V]--syntax-definition\f[R]), the values
pandoc.1:1797: --------------------------------- ----------------------------------
pandoc.1:1817: --------------------------------- ----------------------------------
pandoc.1:1818: --from markdown+emoji from: markdown+emoji
pandoc.1:1823: --to markdown+hard_line_breaks
pandoc.1:1827: --output foo.pdf output-file: foo.pdf
pandoc.1:1829: --output - output-file:
pandoc.1:1831: --data-dir dir data-dir: dir
pandoc.1:1833: --defaults file defaults:
pandoc.1:1836: --verbose verbosity: INFO
pandoc.1:1838: --quiet verbosity: ERROR
pandoc.1:1840: --fail-if-warnings fail-if-warnings: true
pandoc.1:1842: --sandbox sandbox: true
pandoc.1:1844: --log=FILE log-file: FILE
pandoc.1:1862: --------------------------------- ----------------------------------
pandoc.1:1863: --shift-heading-level-by -1 shift-heading-level-by: -1
pandoc.1:1866: --indented-code-classes python - python
pandoc.1:1869: --default-image-extension \[dq].jpg\[dq] default-image-extension: \[aq].jpg\[aq]
pandoc.1:1871: --file-scope file-scope: true
pandoc.1:1873: --filter pandoc-citeproc \[rs] filters:
pandoc.1:1875: --lua-filter count-words.lua \[rs] - count-words.lua
pandoc.1:1876: --filter special.lua - type: json
pandoc.1:1879: --metadata key=value \[rs] metadata:
pandoc.1:1880: --metadata key2 key: value
pandoc.1:1883: --metadata-file meta.yaml metadata-files:
pandoc.1:1888: --preserve-tabs preserve-tabs: true
pandoc.1:1890: --tab-stop 8 tab-stop: 8
pandoc.1:1892: --track-changes accept track-changes: accept
pandoc.1:1894: --extract-media dir extract-media: dir
pandoc.1:1896: --abbreviations abbrevs.txt abbreviations: abbrevs.txt
pandoc.1:1898: --trace trace: true
pandoc.1:1920: --------------------------------- ----------------------------------
pandoc.1:1921: --standalone standalone: true
pandoc.1:1923: --template letter template: letter
pandoc.1:1925: --variable key=val \[rs] variables:
pandoc.1:1926: --variable key2 key: val
pandoc.1:1929: --eol nl eol: nl
pandoc.1:1931: --dpi 300 dpi: 300
pandoc.1:1933: --wrap 60 wrap: 60
pandoc.1:1935: --columns 72 columns: 72
pandoc.1:1937: --table-of-contents table-of-contents: true
pandoc.1:1939: --toc toc: true
pandoc.1:1941: --toc-depth 3 toc-depth: 3
pandoc.1:1943: --strip-comments strip-comments: true
pandoc.1:1945: --no-highlight highlight-style: null
pandoc.1:1947: --highlight-style kate highlight-style: kate
pandoc.1:1950: --syntax-definition mylang.xml - mylang.xml
pandoc.1:1954: --include-in-header inc.tex include-in-header:
pandoc.1:1958:--include-before-body inc.tex - inc.tex
pandoc.1:1960: --include-after-body inc.tex include-after-body:
pandoc.1:1963: --resource-path .:foo resource-path: [\[aq].\[aq],\[aq]foo\[aq]]
pandoc.1:1965: --request-header foo:bar request-headers:
pandoc.1:1969: --no-check-certificate no-check-certificate: true
pandoc.1:1981: --------------------------------- ----------------------------------
pandoc.1:1982: --self-contained self-contained: true
pandoc.1:1984: --html-q-tags html-q-tags: true
pandoc.1:1986: --ascii ascii: true
pandoc.1:1988: --reference-links reference-links: true
pandoc.1:1990: --reference-location block reference-location: block
pandoc.1:1992: --markdown-headings atx markdown-headings: atx
pandoc.1:1994: --list-tables list-tables: true
pandoc.1:1996: --top-level-division chapter top-level-division: chapter
pandoc.1:1998: --number-sections number-sections: true
pandoc.1:2000: --number-offset=1,4 number-offset: \[rs][1,4\[rs]]
pandoc.1:2002: --listings listings: true
pandoc.1:2004: --incremental incremental: true
pandoc.1:2006: --slide-level 2 slide-level: 2
pandoc.1:2008: --section-divs section-divs: true
pandoc.1:2011: --email-obfuscation references
pandoc.1:2013: --id-prefix ch1 identifier-prefix: ch1
pandoc.1:2015: --title-prefix MySite title-prefix: MySite
pandoc.1:2017: --css styles/screen.css \[rs] css:
pandoc.1:2018: --css styles/special.css - styles/screen.css
pandoc.1:2021: --reference-doc my.docx reference-doc: my.docx
pandoc.1:2023: --epub-cover-image cover.jpg epub-cover-image: cover.jpg
pandoc.1:2025: --epub-title-page=false epub-title-page: false
pandoc.1:2027: --epub-metadata meta.xml epub-metadata: meta.xml
pandoc.1:2030: --epub-embed-font special.otf \[rs] - special.otf
pandoc.1:2032: --epub-embed-font headline.otf
pandoc.1:2034: --split-level 2 split-level: 2
pandoc.1:2036: --chunk-template=\[dq]%i.html\[dq] chunk-template: \[dq]%i.html\[dq]
pandoc.1:2038: --epub-subdirectory=\[dq]\[dq] epub-subdirectory: \[aq]\[aq]
pandoc.1:2040: --ipynb-output best ipynb-output: best
pandoc.1:2042: --pdf-engine xelatex pdf-engine: xelatex
pandoc.1:2045: --pdf-engine-opt=--shell-escape - \[aq]-shell-escape\[aq]
pandoc.1:2060: --------------------------------- ----------------------------------
pandoc.1:2061: --citeproc citeproc: true
pandoc.1:2063: --bibliography logic.bib metadata:
pandoc.1:2066: --csl ieee.csl metadata:
pandoc.1:2070: --citation-abbreviations ab.json
pandoc.1:2073: --natbib cite-method: natbib
pandoc.1:2075: --biblatex cite-method: biblatex
pandoc.1:2097: --------------------------------- ----------------------------------
pandoc.1:2098: --mathjax html-math-method:
pandoc.1:2101: --mathml html-math-method:
pandoc.1:2104: --webtex html-math-method:
pandoc.1:2107: --katex html-math-method:
pandoc.1:2110: --gladtex html-math-method:
pandoc.1:2129: --------------------------------- ----------------------------------
pandoc.1:2130: --dump-args dump-args: true
pandoc.1:2132: --ignore-args ignore-args: true
pandoc.1:2139:When the \f[V]-s/--standalone\f[R] option is used, pandoc uses a
pandoc.1:2151:A custom template can be specified using the \f[V]--template\f[R]
pandoc.1:2156:\f[V]--data-dir\f[R], above).
pandoc.1:2169:\f[V]--reference-doc\f[R] to customize the output).
pandoc.1:2173:They may be set at the command line using the \f[V]-V/--variable\f[R]
pandoc.1:2177:blocks or with the \f[V]-M/--metadata\f[R] option.
pandoc.1:2191:Anything between the sequence \f[V]$--\f[R] and the end of the line will
pandoc.1:2522:|----------------------|------------|
pandoc.1:2526:|----------------------|------------|
pandoc.1:2601:---
pandoc.1:2652:---
pandoc.1:2687:---
pandoc.1:2716:engine is fully supported (use \f[V]--pdf-engine=xelatex\f[R]).
pandoc.1:2723:\f[V]pandoc --print-default-data-file=templates/styles.html\f[R]).
pandoc.1:2724:Unless you use \f[V]--css\f[R], this variable is set to \f[V]true\f[R]
pandoc.1:2770:---
pandoc.1:2786:---
pandoc.1:2881:---
pandoc.1:2905:---
pandoc.1:2927:---
pandoc.1:2944:---
pandoc.1:2976:numbering depth for sections (with \f[V]--number-sections\f[R] option or
pandoc.1:3002:---
pandoc.1:3035:---
pandoc.1:3091:\f[V]--toc/--table-of-contents\f[R])
pandoc.1:3103:bibliography style, when used with \f[V]--natbib\f[R] and
pandoc.1:3104:\f[V]--biblatex\f[R]
pandoc.1:3107:bibliography title, when used with \f[V]--natbib\f[R] and
pandoc.1:3108:\f[V]--biblatex\f[R]
pandoc.1:3170:\f[V]--metadata=pdfa\f[R] or \f[V]pdfa: true\f[R] in a YAML metadata
pandoc.1:3173:Using \f[V]--variable=pdfa\f[R] without specified value is not
pandoc.1:3198:\f[V]--toc/--table-of-contents\f[R])
pandoc.1:3215:The \f[V]--css\f[R] option also affects the output.
pandoc.1:3306:contents specified by \f[V]-H/--include-in-header\f[R] (may have
pandoc.1:3310:contents specified by \f[V]-B/--include-before-body\f[R] (may have
pandoc.1:3314:contents specified by \f[V]-A/--include-after-body\f[R] (may have
pandoc.1:3322:non-null value if \f[V]-N/--number-sections\f[R] was specified
pandoc.1:3356:non-null value if \f[V]--toc/--table-of-contents\f[R] was specified
pandoc.1:3368:For example, \f[V]--from markdown_strict+footnotes\f[R] is strict
pandoc.1:3370:\f[V]--from markdown-footnotes-pipe_tables\f[R] is pandoc\[cq]s Markdown
pandoc.1:3382:\f[V]--markdown-headings\f[R]).
pandoc.1:3386:Interpret straight quotes as curly quotes, \f[V]---\f[R] as em-dashes,
pandoc.1:3387:\f[V]--\f[R] as en-dashes, and \f[V]...\f[R] as ellipses.
pandoc.1:3412:and dashes (\f[V]--\f[R] for en-dash and \f[V]---\f[R] for em-dash).
pandoc.1:3461: ----------------------------- -----------------------------
pandoc.1:3464: *Dogs*?--in *my* house? dogs--in-my-house
pandoc.1:3483:contents generated by the \f[V]--toc|--table-of-contents\f[R] option.
pandoc.1:3498:If the \f[V]--section-divs\f[R] option is specified, then each section
pandoc.1:3829:-------------------
pandoc.1:3903:---------------
pandoc.1:3918:if \f[V]--number-sections\f[R] is specified.
pandoc.1:4162:\f[V]pandoc --list-highlight-languages\f[R].)
pandoc.1:4226:To prevent all highlighting, use the \f[V]--no-highlight\f[R] flag.
pandoc.1:4227:To set the highlighting style, use \f[V]--highlight-style\f[R].
pandoc.1:4632:<!-- end of list -->
pandoc.1:4647:<!-- -->
pandoc.1:4664:---------------
pandoc.1:4693:------- ------ ---------- -------
pandoc.1:4727:------- ------ ---------- -------
pandoc.1:4731:------- ------ ---------- -------
pandoc.1:4748:-------------------------------------------------------------
pandoc.1:4751:----------- ------- --------------- -------------------------
pandoc.1:4758:-------------------------------------------------------------
pandoc.1:4784:----------- ------- --------------- -------------------------
pandoc.1:4791:----------- ------- --------------- -------------------------
pandoc.1:4808:+---------------+---------------+--------------------+
pandoc.1:4813:+---------------+---------------+--------------------+
pandoc.1:4816:+---------------+---------------+--------------------+
pandoc.1:4829:+---------------------+----------+
pandoc.1:4833:| Temperature +-------+----------+
pandoc.1:4835:| +-------+----------+
pandoc.1:4837:+-------------+-------+----------+
pandoc.1:4845:+---------------------+-----------------------+
pandoc.1:4848:| +-------+-------+-------+
pandoc.1:4852:+---------------------+-------+-------+-------+
pandoc.1:4854:+---------------------+-------+-------+-------+
pandoc.1:4863:+---------------+---------------+--------------------+
pandoc.1:4867:+---------------+---------------+--------------------+
pandoc.1:4875:+--------------:+:--------------+:------------------:+
pandoc.1:4877:+---------------+---------------+--------------------+
pandoc.1:4886: +---------------+---------------+
pandoc.1:4890: +---------------+---------------+
pandoc.1:4909:|------:|:-----|---------|:------:|
pandoc.1:4932:-----|-----:
pandoc.1:4942:\f[V]--columns\f[R]), then the table will take up the full text width
pandoc.1:4946:(For example \f[V]---|-\f[R] would make the first column 3/4 and the
pandoc.1:4958:|-----+-------|
pandoc.1:5044:when the \f[V]--standalone\f[R] (\f[V]-s\f[R]) option is chosen.
pandoc.1:5049:(\f[V]--title-prefix\f[R] or \f[V]-T\f[R] option).
pandoc.1:5092:three hyphens (\f[V]---\f[R]) at the top and a line of three hyphens
pandoc.1:5093:(\f[V]---\f[R]) or three dots (\f[V]...\f[R]) at the bottom.
pandoc.1:5094:The initial line \f[V]---\f[R] must not be followed by a blank line.
pandoc.1:5109:Just be sure that the YAML file begins with \f[V]---\f[R] and ends with
pandoc.1:5110:\f[V]---\f[R] or \f[V]...\f[R].
pandoc.1:5111:Alternatively, you can use the \f[V]--metadata-file\f[R] option.
pandoc.1:5136:\f[V]-s/--standalone\f[R] option is used.
pandoc.1:5151:---
pandoc.1:5194:---
pandoc.1:5299:\f[V]--ascii\f[R] command-line option to make it appear as an explicit
pandoc.1:5560:If the \f[V]--mathml\f[R] flag is used, it will be rendered using MathML
pandoc.1:5568:If the \f[V]--webtex\f[R] option is used, formulas are rendered as
pandoc.1:5682:18--25 & 15 \[rs]\[rs]
pandoc.1:5683:26--35 & 33 \[rs]\[rs]
pandoc.1:5684:36--45 & 22 \[rs]\[rs] \[rs]hline
pandoc.1:5737:\f[V]-t/--to\f[R], above, for a list, or use
pandoc.1:5738:\f[V]pandoc --list-output-formats\f[R]).
pandoc.1:5743:output (depending on what you use for \f[V]--pdf-engine\f[R]).
pandoc.1:6025:\f[V]--dpi\f[R] option (by default, 96 dpi is assumed, unless the image
pandoc.1:6220:In \f[V]\[at]Foo_bar--baz\f[R], the key is \f[V]Foo_bar\f[R] because the
pandoc.1:6401:\f[V]-\f[R] before a numeral is an en-dash, and \f[V]--\f[R] is an
pandoc.1:6575:Using \f[V]--from=markdown+wikilinks_title_after_pipe\f[R] results in
pandoc.1:6583:while using \f[V]--from=markdown+wikilinks_title_before_pipe\f[R]
pandoc.1:6615:pandoc --list-extensions=FORMAT
pandoc.1:6628:When the \f[V]--citeproc\f[R] option is used, pandoc can automatically
pandoc.1:6634:pandoc --citeproc myinput.txt
pandoc.1:6650:\f[V]--bibliography\f[R] command line argument.
pandoc.1:6652:\f[V]--bibliography\f[R] arguments or set \f[V]bibliography\f[R]
pandoc.1:6660: ---------- ----------------
pandoc.1:6697:\f[V]--bibliography\f[R] or the YAML metadata field
pandoc.1:6705:---
pandoc.1:6757:Running pandoc on a bibliography file with the \f[V]--citeproc\f[R]
pandoc.1:6763:pandoc chem.bib -s --citeproc -o chem.html
pandoc.1:6764:pandoc chem.bib -s --citeproc -o chem.pdf
pandoc.1:6855:These files are specified using the \f[V]--csl\f[R] option or the
pandoc.1:6864:The \f[V]--citation-abbreviations\f[R] option (or the
pandoc.1:6958:---
pandoc.1:6976:---
pandoc.1:6994:---
pandoc.1:7004:\f[V]--natbib\f[R] or \f[V]--biblatex\f[R] argument to pandoc
pandoc.1:7007:\f[V]--natbib\f[R]) or BibLaTeX (for \f[V]--biblatex\f[R]) format.
pandoc.1:7100:------------------
pandoc.1:7123:the \f[V]-s/--standalone\f[R] option embeds a link to JavaScript and CSS
pandoc.1:7134:With all HTML slide formats, the \f[V]--self-contained\f[R] option can
pandoc.1:7164:This default can be overridden using the \f[V]--slide-level\f[R] option.
pandoc.1:7196:\f[V]--slide-level=0\f[R].
pandoc.1:7202:reveal.js unless you set \f[V]--slide-level=0\f[R] (which lets reveal.js
pandoc.1:7245:\f[V]--reference-doc\f[R].
pandoc.1:7333:\f[V]$DATADIR\f[R] is the user data directory (see \f[V]--data-dir\f[R],
pandoc.1:7352:Or you can specify a custom stylesheet using the \f[V]--css\f[R] option.
pandoc.1:7557:---
pandoc.1:7563:---
pandoc.1:7577:EPUB metadata may be specified using the \f[V]--epub-metadata\f[R]
pandoc.1:7584:---
pandoc.1:7745: ---------------------------- -------------------
pandoc.1:7804:(To see this, use \f[V]pandoc --print-default-data-file epub.css\f[R].)
pandoc.1:7805:To use a different CSS file, just use the \f[V]--css\f[R] command line
pandoc.1:7845:---
pandoc.1:7864:---
pandoc.1:7957:For example, \f[V]--wrap=preserve\f[R] will preserve soft line breaks in
pandoc.1:7958:Markdown cells; \f[V]--markdown-headings=setext\f[R] will cause
pandoc.1:7959:Setext-style headings to be used; and \f[V]--preserve-tabs\f[R] will
pandoc.1:7969:\f[V]pandoc --list-highlight-languages\f[R].
pandoc.1:7971:The color scheme can be selected using the \f[V]--highlight-style\f[R]
pandoc.1:7977:\f[V]pandoc --list-highlight-styles\f[R].
pandoc.1:7980:\f[V]--print-highlight-style\f[R] to generate a JSON \f[V].theme\f[R]
pandoc.1:7982:\f[V]--highlight-style\f[R].
pandoc.1:7987:pandoc --print-highlight-style pygments > my.theme
pandoc.1:7995:pandoc --highlight-style my.theme
pandoc.1:8001:\f[V]--syntax-definition\f[R] option to load a KDE-style XML syntax
pandoc.1:8006:To disable highlighting, use the \f[V]--no-highlight\f[R] option.
pandoc.1:8042:| A Bird came down the Walk---
pandoc.1:8043:| He did not know I saw---
pandoc.1:8139:(see \f[V]--data-dir\f[R]).
pandoc.1:8150:pandoc --print-default-data-file creole.lua
pandoc.1:8163:If you want to use \f[V]--standalone\f[R] with a custom writer, you will
pandoc.1:8164:need to specify a template manually using \f[V]--template\f[R] or add a
pandoc.1:8221:pandoc --to=context+tagging -V pdfa=3a
pandoc.1:8235:pandoc --pdf-engine=weasyprint \[rs]
pandoc.1:8236: --pdf-engine-opt=--pdf-variant=pdf/ua-1 ...
pandoc.1:8250:pandoc --pdf-engine=prince \[rs]
pandoc.1:8251: --pdf-engine-opt=--tagged-pdf ...
pandoc.1:8304:(Using the \f[V]--sandbox\f[R] option can protect against this threat.)
pandoc.1:8307:\f[V]--self-contained\f[R], EPUB, Docx, and ODT) will embed encoded or
pandoc.1:8311:(Using the \f[V]--sandbox\f[R] option can protect against this threat,
pandoc.1:8319:(This corresponds to the use of the \f[V]--sandbox\f[R] option on the
-.-.
Change -- in x--y to \(em (em-dash), or, if an
option, to \-\-
114:You can also use \f[V]pandoc --list-input-formats\f[R] and
115:\f[V]pandoc --list-output-formats\f[R] to print lists of supported
230:pandoc -f html -t markdown --request-header User-Agent:\[dq]Mozilla/5.0\[dq] \[rs]
500:at the output of \f[V]pandoc --version\f[R].
529:eval \[dq]$(pandoc --bash-completion)\[dq]
640:pandoc --filter ./caps.py -t latex
779:\f[V]pandoc --print-default-data-file=abbreviations\f[R].
1000:\f[V]--resource-path foo:bar --resource-path baz:bim\f[R] is equivalent
1018:\f[VI]--embed-resources --standalone\f[I].\f[R]
1213:\f[V]pandoc -o custom-reference.docx --print-default-data-file reference.docx\f[R].
1315:\f[V]pandoc -o custom-reference.odt --print-default-data-file reference.odt\f[R].
1355:\f[V]pandoc -o custom-reference.pptx --print-default-data-file reference.pptx\f[R],
1641:pandoc -s --gladtex input.md -o myfile.htex
1670:pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1
1776:from any directory using \f[V]pandoc --defaults letter\f[R] or
1818: --from markdown+emoji from: markdown+emoji
1823: --to markdown+hard_line_breaks
1827: --output foo.pdf output-file: foo.pdf
1829: --output - output-file:
1831: --data-dir dir data-dir: dir
1833: --defaults file defaults:
1836: --verbose verbosity: INFO
1838: --quiet verbosity: ERROR
1840: --fail-if-warnings fail-if-warnings: true
1842: --sandbox sandbox: true
1844: --log=FILE log-file: FILE
1863: --shift-heading-level-by -1 shift-heading-level-by: -1
1866: --indented-code-classes python - python
1869: --default-image-extension \[dq].jpg\[dq] default-image-extension: \[aq].jpg\[aq]
1871: --file-scope file-scope: true
1873: --filter pandoc-citeproc \[rs] filters:
1875: --lua-filter count-words.lua \[rs] - count-words.lua
1876: --filter special.lua - type: json
1879: --metadata key=value \[rs] metadata:
1880: --metadata key2 key: value
1883: --metadata-file meta.yaml metadata-files:
1888: --preserve-tabs preserve-tabs: true
1890: --tab-stop 8 tab-stop: 8
1892: --track-changes accept track-changes: accept
1894: --extract-media dir extract-media: dir
1896: --abbreviations abbrevs.txt abbreviations: abbrevs.txt
1898: --trace trace: true
1921: --standalone standalone: true
1923: --template letter template: letter
1925: --variable key=val \[rs] variables:
1926: --variable key2 key: val
1929: --eol nl eol: nl
1931: --dpi 300 dpi: 300
1933: --wrap 60 wrap: 60
1935: --columns 72 columns: 72
1937: --table-of-contents table-of-contents: true
1939: --toc toc: true
1941: --toc-depth 3 toc-depth: 3
1943: --strip-comments strip-comments: true
1945: --no-highlight highlight-style: null
1947: --highlight-style kate highlight-style: kate
1950: --syntax-definition mylang.xml - mylang.xml
1954: --include-in-header inc.tex include-in-header:
1960: --include-after-body inc.tex include-after-body:
1963: --resource-path .:foo resource-path: [\[aq].\[aq],\[aq]foo\[aq]]
1965: --request-header foo:bar request-headers:
1969: --no-check-certificate no-check-certificate: true
1982: --self-contained self-contained: true
1984: --html-q-tags html-q-tags: true
1986: --ascii ascii: true
1988: --reference-links reference-links: true
1990: --reference-location block reference-location: block
1992: --markdown-headings atx markdown-headings: atx
1994: --list-tables list-tables: true
1996: --top-level-division chapter top-level-division: chapter
1998: --number-sections number-sections: true
2000: --number-offset=1,4 number-offset: \[rs][1,4\[rs]]
2002: --listings listings: true
2004: --incremental incremental: true
2006: --slide-level 2 slide-level: 2
2008: --section-divs section-divs: true
2011: --email-obfuscation references
2013: --id-prefix ch1 identifier-prefix: ch1
2015: --title-prefix MySite title-prefix: MySite
2017: --css styles/screen.css \[rs] css:
2018: --css styles/special.css - styles/screen.css
2021: --reference-doc my.docx reference-doc: my.docx
2023: --epub-cover-image cover.jpg epub-cover-image: cover.jpg
2025: --epub-title-page=false epub-title-page: false
2027: --epub-metadata meta.xml epub-metadata: meta.xml
2030: --epub-embed-font special.otf \[rs] - special.otf
2032: --epub-embed-font headline.otf
2034: --split-level 2 split-level: 2
2036: --chunk-template=\[dq]%i.html\[dq] chunk-template: \[dq]%i.html\[dq]
2038: --epub-subdirectory=\[dq]\[dq] epub-subdirectory: \[aq]\[aq]
2040: --ipynb-output best ipynb-output: best
2042: --pdf-engine xelatex pdf-engine: xelatex
2045: --pdf-engine-opt=--shell-escape - \[aq]-shell-escape\[aq]
2061: --citeproc citeproc: true
2063: --bibliography logic.bib metadata:
2066: --csl ieee.csl metadata:
2070: --citation-abbreviations ab.json
2073: --natbib cite-method: natbib
2075: --biblatex cite-method: biblatex
2098: --mathjax html-math-method:
2101: --mathml html-math-method:
2104: --webtex html-math-method:
2107: --katex html-math-method:
2110: --gladtex html-math-method:
2130: --dump-args dump-args: true
2132: --ignore-args ignore-args: true
2723:\f[V]pandoc --print-default-data-file=templates/styles.html\f[R]).
3464: *Dogs*?--in *my* house? dogs--in-my-house
4162:\f[V]pandoc --list-highlight-languages\f[R].)
5738:\f[V]pandoc --list-output-formats\f[R]).
6220:In \f[V]\[at]Foo_bar--baz\f[R], the key is \f[V]Foo_bar\f[R] because the
6615:pandoc --list-extensions=FORMAT
6634:pandoc --citeproc myinput.txt
6763:pandoc chem.bib -s --citeproc -o chem.html
6764:pandoc chem.bib -s --citeproc -o chem.pdf
7804:(To see this, use \f[V]pandoc --print-default-data-file epub.css\f[R].)
7969:\f[V]pandoc --list-highlight-languages\f[R].
7977:\f[V]pandoc --list-highlight-styles\f[R].
7987:pandoc --print-highlight-style pygments > my.theme
7995:pandoc --highlight-style my.theme
8150:pandoc --print-default-data-file creole.lua
8221:pandoc --to=context+tagging -V pdfa=3a
8235:pandoc --pdf-engine=weasyprint \[rs]
8236: --pdf-engine-opt=--pdf-variant=pdf/ua-1 ...
8250:pandoc --pdf-engine=prince \[rs]
8251: --pdf-engine-opt=--tagged-pdf ...
-.-.
Add a (no-break, "\ " or "\~") space between a number and a unit,
as these are not one entity.
870:The default is 96dpi.
1391:It is recommended that the image be less than 1000px in width and
2734:e.g.\ \f[V]20px\f[R], but it also accepts \f[V]pt\f[R] (12pt = 16px in
3014:The standard classes allow 10pt, 11pt, and 12pt.
-.-.
Change - to \- if it shall be printed as a minus sign.
pandoc.1:3477:\f[V]-2\f[R]; and so on.
pandoc.1:4832:| | min | -89.2 °C |
pandoc.1:4851:| Antarctica | -89.2 | N/A | 19.8 |
pandoc.1:4853:| Earth | -89.2 | 14 | 56.7 |
See "www.gnu.org/prep/standards".
Think about translations into other languages!
pandoc.1:4385:bad but is legal.
pandoc.1:4927:So, this is a perfectly legal (though ugly) pipe table:
-.-.
Change a HYPHEN-MINUS (code 0x2D) to a minus(-dash) (\-),
if it
is in front of a name for an option,
is a symbol for standard input,
is a single character used to indicate an option,
or is in the NAME section (man-pages(7)).
N.B. - (0x2D), processed as a UTF-8 file, is changed to a hyphen
(0x2010, groff \[u2010] or \[hy]) in the output.
20:pandoc - general markup converter
32:For the full lists of input and output formats, see the \f[V]--from\f[R]
33:and \f[V]--to\f[R] options below.
64:For output to a file, use the \f[V]-o\f[R] option:
68:pandoc -o output.html input.txt
74:\f[V]<head>\f[R] and \f[V]<body>\f[R]), use the \f[V]-s\f[R] or
75:\f[V]--standalone\f[R] flag:
79:pandoc -s -o output.html input.txt
88:(Use \f[V]--file-scope\f[R] to parse files individually.)
93:The input format can be specified using the \f[V]-f/--from\f[R] option,
94:the output format using the \f[V]-t/--to\f[R] option.
100:pandoc -f markdown -t latex hello.txt
108:pandoc -f html -t markdown hello.html
113:\f[V]-f\f[R] for input formats and \f[V]-t\f[R] for output formats).
114:You can also use \f[V]pandoc --list-input-formats\f[R] and
115:\f[V]pandoc --list-output-formats\f[R] to print lists of supported
124:pandoc -o hello.tex hello.txt
143:iconv -t utf-8 input.txt | pandoc | iconv -f utf-8
150:the \f[V]-s/--standalone\f[R] option.
158:pandoc test.txt -o test.pdf
163:a LaTeX engine be installed (see \f[V]--pdf-engine\f[R] below).
167:before, but add the \f[V]--pdf-engine\f[R] option or
168:\f[V]-t context\f[R], \f[V]-t html\f[R], or \f[V]-t ms\f[R] to the
171:specified using \f[V]--pdf-engine\f[R].
177:using \f[V]--css\f[R].
180:representation: instead of \f[V]-o test.pdf\f[R], use for example
181:\f[V]-s -o test.tex\f[R] to output the generated LaTeX.
187:\f[V]iftex\f[R], \f[V]listings\f[R] (if the \f[V]--listings\f[R] option
221:pandoc -f html -t markdown https://www.fsf.org
230:pandoc -f html -t markdown --request-header User-Agent:\[dq]Mozilla/5.0\[dq] \[rs]
237:\f[V]-f\f[R] \f[I]FORMAT\f[R], \f[V]-r\f[R] \f[I]FORMAT\f[R], \f[V]--from=\f[R]\f[I]FORMAT\f[R], \f[V]--read=\f[R]\f[I]FORMAT\f[R]
331:\f[V]+EXTENSION\f[R] or \f[V]-EXTENSION\f[R] to the format name.
333:See \f[V]--list-input-formats\f[R] and \f[V]--list-extensions\f[R],
337:\f[V]-t\f[R] \f[I]FORMAT\f[R], \f[V]-w\f[R] \f[I]FORMAT\f[R], \f[V]--to=\f[R]\f[I]FORMAT\f[R], \f[V]--write=\f[R]\f[I]FORMAT\f[R]
467:forced with \f[V]-o -\f[R].
470:\f[V]+EXTENSION\f[R] or \f[V]-EXTENSION\f[R] to the format name.
472:See \f[V]--list-output-formats\f[R] and \f[V]--list-extensions\f[R],
476:\f[V]-o\f[R] \f[I]FILE\f[R], \f[V]--output=\f[R]\f[I]FILE\f[R]
478:If \f[I]FILE\f[R] is \f[V]-\f[R], output will go to \f[I]stdout\f[R],
487:\f[V]--data-dir=\f[R]\f[I]DIRECTORY\f[R]
500:at the output of \f[V]pandoc --version\f[R].
507:\f[V]-d\f[R] \f[I]FILE\f[R], \f[V]--defaults=\f[R]\f[I]FILE\f[R]
515:\f[V]--data-dir\f[R]).
521:\f[V]--bash-completion\f[R]
529:eval \[dq]$(pandoc --bash-completion)\[dq]
534:\f[V]--verbose\f[R]
537:\f[V]--quiet\f[R]
540:\f[V]--fail-if-warnings\f[R]
543:\f[V]--log=\f[R]\f[I]FILE\f[R]
546:settings (\f[V]--verbose\f[R], \f[V]--quiet\f[R]).
548:\f[V]--list-input-formats\f[R]
551:\f[V]--list-output-formats\f[R]
554:\f[V]--list-extensions\f[R][\f[V]=\f[R]\f[I]FORMAT\f[R]]
556:by a \f[V]+\f[R] or \f[V]-\f[R] indicating whether it is enabled by
561:\f[V]--list-highlight-languages\f[R]
564:\f[V]--list-highlight-styles\f[R]
566:See \f[V]--highlight-style\f[R].
568:\f[V]-v\f[R], \f[V]--version\f[R]
571:\f[V]-h\f[R], \f[V]--help\f[R]
575:\f[V]--shift-heading-level-by=\f[R]\f[I]NUMBER\f[R]
577:For example, with \f[V]--shift-heading-level-by=-1\f[R], level 2
582:Exception: with a shift of -N, a level-N heading at the beginning of the
584:\f[V]--shift-heading-level-by=-1\f[R] is a good choice when converting
587:\f[V]--shift-heading-level-by=1\f[R] may be a good choice for converting
591:\f[V]--base-header-level=\f[R]\f[I]NUMBER\f[R]
593:Use \f[VI]--shift-heading-level-by\f[I]=X instead, where X = NUMBER -
596:\f[V]--indented-code-classes=\f[R]\f[I]CLASSES\f[R]
601:\f[V]--default-image-extension=\f[R]\f[I]EXTENSION\f[R]
608:\f[V]--file-scope\f[R]
613:Reading binary files (docx, odt, epub) implies \f[V]--file-scope\f[R].
616:If two or more files are processed using \f[V]--file-scope\f[R],
628:\f[V]-F\f[R] \f[I]PROGRAM\f[R], \f[V]--filter=\f[R]\f[I]PROGRAM\f[R]
640:pandoc --filter ./caps.py -t latex
648:pandoc -t json | ./caps.py latex | pandoc -f json -t latex
667:\f[V]$DATADIR\f[R] is the user data directory (see \f[V]--data-dir\f[R],
676:\f[V]-L\f[R] \f[I]SCRIPT\f[R], \f[V]--lua-filter=\f[R]\f[I]SCRIPT\f[R]
678:\f[V]--filter\f[R]), but use pandoc\[cq]s built-in Lua filtering system.
697:directory (see \f[V]--data-dir\f[R], above).
703:\f[V]-M\f[R] \f[I]KEY\f[R][\f[V]=\f[R]\f[I]VAL\f[R]], \f[V]--metadata=\f[R]\f[I]KEY\f[R][\f[V]:\f[R]\f[I]VAL\f[R]]
709:Like \f[V]--variable\f[R], \f[V]--metadata\f[R] causes template
711:But unlike \f[V]--variable\f[R], \f[V]--metadata\f[R] affects the
716:\f[V]--metadata-file=\f[R]\f[I]FILE\f[R]
726:Metadata values specified inside the document, or by using \f[V]-M\f[R],
730:\f[V]--data-dir\f[R]).
732:\f[V]-p\f[R], \f[V]--preserve-tabs\f[R]
739:\f[V]--tab-stop=\f[R]\f[I]NUMBER\f[R]
742:\f[V]--track-changes=accept\f[R]|\f[V]reject\f[R]|\f[V]all\f[R]
762:\f[V]--extract-media=\f[R]\f[I]DIR\f[R]
773:\f[V]--abbreviations=\f[R]\f[I]FILE\f[R]
779:\f[V]pandoc --print-default-data-file=abbreviations\f[R].
785:\f[V]--trace\f[R]
791:\f[V]-s\f[R], \f[V]--standalone\f[R]
800:\f[V]--template=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
802:Implies \f[V]--standalone\f[R].
805:will be added, so that \f[V]--template=special\f[R] looks for
809:\f[V]--data-dir\f[R]).
811:output format will be used (see \f[V]-D/--print-default-template\f[R]).
813:\f[V]-V\f[R] \f[I]KEY\f[R][\f[V]=\f[R]\f[I]VAL\f[R]], \f[V]--variable=\f[R]\f[I]KEY\f[R][\f[V]:\f[R]\f[I]VAL\f[R]]
819:\f[V]--sandbox\f[R]
832:find them when run in \f[V]--sandbox\f[R] mode and will raise an error.
838:\f[V]-D\f[R] \f[I]FORMAT\f[R], \f[V]--print-default-template=\f[R]\f[I]FORMAT\f[R]
840:(See \f[V]-t\f[R] for a list of possible \f[I]FORMAT\f[R]s.)
842:This option may be used with \f[V]-o\f[R]/\f[V]--output\f[R] to redirect
843:output to a file, but \f[V]-o\f[R]/\f[V]--output\f[R] must come before
844:\f[V]--print-default-template\f[R] on the command line.
849:To print the partials, use \f[V]--print-default-data-file\f[R]: for
850:example, \f[V]--print-default-data-file=templates/styles.html\f[R].
853:\f[V]--print-default-data-file=\f[R]\f[I]FILE\f[R]
856:This option may be used with \f[V]-o\f[R]/\f[V]--output\f[R] to redirect
857:output to a file, but \f[V]-o\f[R]/\f[V]--output\f[R] must come before
858:\f[V]--print-default-data-file\f[R] on the command line.
860:\f[V]--eol=crlf\f[R]|\f[V]lf\f[R]|\f[V]native\f[R]
866:\f[V]--dpi\f[R]=\f[I]NUMBER\f[R]
874:\f[V]--wrap=auto\f[R]|\f[V]none\f[R]|\f[V]preserve\f[R]
878:the column width specified by \f[V]--columns\f[R] (default 72).
887:\f[V]--columns=\f[R]\f[I]NUMBER\f[R]
890:\f[V]--wrap\f[R]).
894:\f[V]--toc\f[R], \f[V]--table-of-contents\f[R]
899:This option has no effect unless \f[V]-s/--standalone\f[R] is used, and
907:\f[V]--pdf-engine-opt=--no-toc-relocation\f[R].
910:\f[V]--toc-depth=\f[R]\f[I]NUMBER\f[R]
916:\f[V]--strip-comments\f[R]
922:\f[V]--no-highlight\f[R]
926:\f[V]--highlight-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
933:See also \f[V]--list-highlight-styles\f[R].
942:\f[V]--print-highlight-style\f[R].
945:\f[V]--print-highlight-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
948:\f[V]--highlight-style\f[R].
949:This option may be used with \f[V]-o\f[R]/\f[V]--output\f[R] to redirect
950:output to a file, but \f[V]-o\f[R]/\f[V]--output\f[R] must come before
951:\f[V]--print-highlight-style\f[R] on the command line.
953:\f[V]--syntax-definition=\f[R]\f[I]FILE\f[R]
960:\f[V]-H\f[R] \f[I]FILE\f[R], \f[V]--include-in-header=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
967:Implies \f[V]--standalone\f[R].
969:\f[V]-B\f[R] \f[I]FILE\f[R], \f[V]--include-before-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
977:Implies \f[V]--standalone\f[R].
979:\f[V]-A\f[R] \f[I]FILE\f[R], \f[V]--include-after-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
985:Implies \f[V]--standalone\f[R].
987:\f[V]--resource-path=\f[R]\f[I]SEARCHPATH\f[R]
991:If \f[V]--resource-path\f[R] is not specified, the default resource path
993:Note that, if \f[V]--resource-path\f[R] is specified, the working
995:For example: \f[V]--resource-path=.:test\f[R] will search the working
1000:\f[V]--resource-path foo:bar --resource-path baz:bim\f[R] is equivalent
1001:to \f[V]--resource-path baz:bim:foo:bar\f[R].
1003:\f[V]--request-header=\f[R]\f[I]NAME\f[R]\f[V]:\f[R]\f[I]VAL\f[R]
1010:\f[V]--no-check-certificate\f[R]
1016:\f[V]--self-contained\f[R]
1018:\f[VI]--embed-resources --standalone\f[I].\f[R]
1020:\f[V]--embed-resources\f[R]
1040:\f[V]--mathjax\f[R] is used, and some advanced features (e.g.\ zoom or
1044:\f[V]--html-q-tags\f[R]
1049:\f[V]--ascii\f[R]
1057:\f[V]--reference-links\f[R]
1062:\f[V]--reference-location\f[R] option.
1064:\f[V]--reference-location=block\f[R]|\f[V]section\f[R]|\f[V]document\f[R]
1073:In slide formats, specifying \f[V]--reference-location=section\f[R] will
1076:\f[V]--markdown-headings=setext\f[R]|\f[V]atx\f[R]
1077:Specify whether to use ATX-style (\f[V]#\f[R]-prefixed) or Setext-style
1083:\f[V]--list-tables\f[R]
1086:\f[V]--top-level-division=default\f[R]|\f[V]section\f[R]|\f[V]chapter\f[R]|\f[V]part\f[R]
1102:\f[V]-N\f[R], \f[V]--number-sections\f[R]
1107:\f[V]--number-sections\f[R] is specified.
1109:\f[V]--number-offset=\f[R]\f[I]NUMBER\f[R][\f[V],\f[R]\f[I]NUMBER\f[R]\f[V],\f[R]\f[I]\&...\f[R]]
1116:\f[V]--number-offset=5\f[R].
1118:numbered \[lq]1.5\[rq], specify \f[V]--number-offset=1,4\f[R].
1120:Implies \f[V]--number-sections\f[R].
1122:\f[V]--listings\f[R]
1129:\f[V]-i\f[R], \f[V]--incremental\f[R]
1133:\f[V]--slide-level=\f[R]\f[I]NUMBER\f[R]
1148:\f[V]--section-divs\f[R]
1154:\f[V]--email-obfuscation=none\f[R]|\f[V]javascript\f[R]|\f[V]references\f[R]
1163:\f[V]--id-prefix=\f[R]\f[I]STRING\f[R]
1170:\f[V]-T\f[R] \f[I]STRING\f[R], \f[V]--title-prefix=\f[R]\f[I]STRING\f[R]
1174:Implies \f[V]--standalone\f[R].
1176:\f[V]-c\f[R] \f[I]URL\f[R], \f[V]--css=\f[R]\f[I]URL\f[R]
1182:It should be used together with \f[V]-s/--standalone\f[R], because the
1190:\f[V]--data-dir\f[R]).
1194:\f[V]--reference-doc=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
1207:\f[V]--data-dir\f[R]).
1213:\f[V]pandoc -o custom-reference.docx --print-default-data-file reference.docx\f[R].
1309:\f[V]--data-dir\f[R]).
1315:\f[V]pandoc -o custom-reference.odt --print-default-data-file reference.odt\f[R].
1355:\f[V]pandoc -o custom-reference.pptx --print-default-data-file reference.pptx\f[R],
1361:\f[V]--split-level=\f[R]\f[I]NUMBER\f[R]
1373:\f[V]--chunk-template=\f[R]\f[I]PATHTEMPLATE\f[R]
1386:\f[V]--epub-chapter-level=\f[R]\f[I]NUMBER\f[R]
1387:\f[I]Deprecated synonym for \f[VI]--split-level\f[I].\f[R]
1389:\f[V]--epub-cover-image=\f[R]\f[I]FILE\f[R]
1397:\f[V]--epub-title-page=true\f[R]|\f[V]false\f[R]
1401:\f[V]--epub-metadata=\f[R]\f[I]FILE\f[R]
1428:\f[V]--epub-embed-font=\f[R]\f[I]FILE\f[R]
1436:following to your CSS (see \f[V]--css\f[R]):
1470:\f[V]--epub-subdirectory=\f[R]\f[I]DIRNAME\f[R]
1476:\f[V]--ipynb-output=all|none|best\f[R]
1485:\f[V]--pdf-engine=\f[R]\f[I]PROGRAM\f[R]
1495:depending on the output format specified using \f[V]-t/--to\f[R]:
1498:\f[V]-t latex\f[R] or none: \f[V]pdflatex\f[R] (other options:
1502:\f[V]-t context\f[R]: \f[V]context\f[R]
1504:\f[V]-t html\f[R]: \f[V]wkhtmltopdf\f[R] (other options:
1508:\f[V]-t ms\f[R]: \f[V]pdfroff\f[R]
1510:\f[V]-t typst\f[R]: \f[V]typst\f[R]
1513:\f[V]--pdf-engine-opt=\f[R]\f[I]STRING\f[R]
1518:\f[V]--pdf-engine-opt=-outdir=foo\f[R].
1522:\f[V]-C\f[R], \f[V]--citeproc\f[R]
1527:\f[V]--bibliography\f[R] option or the \f[V]bibliography\f[R] field in
1531:\f[V]--csl\f[R] option or the \f[V]csl\f[R] field in metadata.
1535:filters or Lua filters (see \f[V]--filter\f[R], \f[V]--lua-filter\f[R]):
1540:\f[V]--bibliography=\f[R]\f[I]FILE\f[R]
1547:will be sought in the resource path (see \f[V]--resource-path\f[R]).
1549:\f[V]--csl=\f[R]\f[I]FILE\f[R]
1552:(This is equivalent to \f[V]--metadata csl=FILE\f[R].)
1555:will be sought in the resource path (see \f[V]--resource-path\f[R]) and
1559:\f[V]--citation-abbreviations=\f[R]\f[I]FILE\f[R]
1563:\f[V]--metadata citation-abbreviations=FILE\f[R].)
1566:will be sought in the resource path (see \f[V]--resource-path\f[R]) and
1570:\f[V]--natbib\f[R]
1572:This option is not for use with the \f[V]--citeproc\f[R] option or with
1577:\f[V]--biblatex\f[R]
1579:This option is not for use with the \f[V]--citeproc\f[R] option or with
1591:will want to use \f[V]--mathjax\f[R] or another of the following
1594:\f[V]--mathjax\f[R][\f[V]=\f[R]\f[I]URL\f[R]]
1604:\f[V]--mathml\f[R]
1612:\f[V]--webtex\f[R][\f[V]=\f[R]\f[I]URL\f[R]]
1617:\f[V]--webtex https://latex.codecogs.com/svg.latex?\f[R].
1620:Note: the \f[V]--webtex\f[R] option will affect Markdown output as well
1624:\f[V]--katex\f[R][\f[V]=\f[R]\f[I]URL\f[R]]
1632:\f[V]--gladtex\f[R]
1641:pandoc -s --gladtex input.md -o myfile.htex
1642:gladtex -d image_dir myfile.htex
1649:\f[V]--dump-args\f[R]
1654:with the \f[V]-o\f[R] option, or \f[V]-\f[R] (for \f[I]stdout\f[R]) if
1659:include any options appearing after a \f[V]--\f[R] separator at the end
1662:\f[V]--ignore-args\f[R]
1670:pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1
1678:pandoc -o foo.html -s
1686:.RS -14n
1691: ------ -------------------------------------
1727:The \f[V]--defaults\f[R] option may be used to specify a package of
1776:from any directory using \f[V]pandoc --defaults letter\f[R] or
1777:\f[V]pandoc -dletter\f[R].
1782:(\f[V]--metadata-file\f[R], \f[V]--css\f[R],
1783:\f[V]--include-in-header\f[R], \f[V]--include-before-body\f[R],
1784:\f[V]--include-after-body\f[R], \f[V]--variable\f[R],
1785:\f[V]--metadata\f[R], \f[V]--syntax-definition\f[R]), the values
1791:.RS -14n
1797: --------------------------------- ----------------------------------
1801: - foo.md
1802: - bar.md
1811:.RS -14n
1817: --------------------------------- ----------------------------------
1818: --from markdown+emoji from: markdown+emoji
1823: --to markdown+hard_line_breaks
1827: --output foo.pdf output-file: foo.pdf
1829: --output - output-file:
1831: --data-dir dir data-dir: dir
1833: --defaults file defaults:
1834: - file
1836: --verbose verbosity: INFO
1838: --quiet verbosity: ERROR
1840: --fail-if-warnings fail-if-warnings: true
1842: --sandbox sandbox: true
1844: --log=FILE log-file: FILE
1856:.RS -14n
1862: --------------------------------- ----------------------------------
1863: --shift-heading-level-by -1 shift-heading-level-by: -1
1866: --indented-code-classes python - python
1869: --default-image-extension \[dq].jpg\[dq] default-image-extension: \[aq].jpg\[aq]
1871: --file-scope file-scope: true
1873: --filter pandoc-citeproc \[rs] filters:
1874: - pandoc-citeproc
1875: --lua-filter count-words.lua \[rs] - count-words.lua
1876: --filter special.lua - type: json
1879: --metadata key=value \[rs] metadata:
1880: --metadata key2 key: value
1883: --metadata-file meta.yaml metadata-files:
1884: - meta.yaml
1888: --preserve-tabs preserve-tabs: true
1890: --tab-stop 8 tab-stop: 8
1892: --track-changes accept track-changes: accept
1894: --extract-media dir extract-media: dir
1896: --abbreviations abbrevs.txt abbreviations: abbrevs.txt
1898: --trace trace: true
1914:.RS -14n
1920: --------------------------------- ----------------------------------
1921: --standalone standalone: true
1923: --template letter template: letter
1925: --variable key=val \[rs] variables:
1926: --variable key2 key: val
1929: --eol nl eol: nl
1931: --dpi 300 dpi: 300
1933: --wrap 60 wrap: 60
1935: --columns 72 columns: 72
1937: --table-of-contents table-of-contents: true
1939: --toc toc: true
1941: --toc-depth 3 toc-depth: 3
1943: --strip-comments strip-comments: true
1945: --no-highlight highlight-style: null
1947: --highlight-style kate highlight-style: kate
1950: --syntax-definition mylang.xml - mylang.xml
1954: --include-in-header inc.tex include-in-header:
1955: - inc.tex
1958:--include-before-body inc.tex - inc.tex
1960: --include-after-body inc.tex include-after-body:
1961: - inc.tex
1963: --resource-path .:foo resource-path: [\[aq].\[aq],\[aq]foo\[aq]]
1965: --request-header foo:bar request-headers:
1967: - [\[dq]User-Agent\[dq], \[dq]Mozilla/5.0\[dq]]
1969: --no-check-certificate no-check-certificate: true
1975:.RS -14n
1981: --------------------------------- ----------------------------------
1982: --self-contained self-contained: true
1984: --html-q-tags html-q-tags: true
1986: --ascii ascii: true
1988: --reference-links reference-links: true
1990: --reference-location block reference-location: block
1992: --markdown-headings atx markdown-headings: atx
1994: --list-tables list-tables: true
1996: --top-level-division chapter top-level-division: chapter
1998: --number-sections number-sections: true
2000: --number-offset=1,4 number-offset: \[rs][1,4\[rs]]
2002: --listings listings: true
2004: --incremental incremental: true
2006: --slide-level 2 slide-level: 2
2008: --section-divs section-divs: true
2011: --email-obfuscation references
2013: --id-prefix ch1 identifier-prefix: ch1
2015: --title-prefix MySite title-prefix: MySite
2017: --css styles/screen.css \[rs] css:
2018: --css styles/special.css - styles/screen.css
2019: - styles/special.css
2021: --reference-doc my.docx reference-doc: my.docx
2023: --epub-cover-image cover.jpg epub-cover-image: cover.jpg
2025: --epub-title-page=false epub-title-page: false
2027: --epub-metadata meta.xml epub-metadata: meta.xml
2030: --epub-embed-font special.otf \[rs] - special.otf
2031: - headline.otf
2032: --epub-embed-font headline.otf
2034: --split-level 2 split-level: 2
2036: --chunk-template=\[dq]%i.html\[dq] chunk-template: \[dq]%i.html\[dq]
2038: --epub-subdirectory=\[dq]\[dq] epub-subdirectory: \[aq]\[aq]
2040: --ipynb-output best ipynb-output: best
2042: --pdf-engine xelatex pdf-engine: xelatex
2045: --pdf-engine-opt=--shell-escape - \[aq]-shell-escape\[aq]
2048: pdf-engine-opt: \[aq]-shell-escape\[aq]
2054:.RS -14n
2060: --------------------------------- ----------------------------------
2061: --citeproc citeproc: true
2063: --bibliography logic.bib metadata:
2066: --csl ieee.csl metadata:
2070: --citation-abbreviations ab.json
2073: --natbib cite-method: natbib
2075: --biblatex cite-method: biblatex
2091:.RS -14n
2097: --------------------------------- ----------------------------------
2098: --mathjax html-math-method:
2101: --mathml html-math-method:
2104: --webtex html-math-method:
2107: --katex html-math-method:
2110: --gladtex html-math-method:
2123:.RS -14n
2129: --------------------------------- ----------------------------------
2130: --dump-args dump-args: true
2132: --ignore-args ignore-args: true
2139:When the \f[V]-s/--standalone\f[R] option is used, pandoc uses a
2146:pandoc -D *FORMAT*
2151:A custom template can be specified using the \f[V]--template\f[R]
2156:\f[V]--data-dir\f[R], above).
2164:\f[V]-t context\f[R], or the \f[V]default.ms\f[R] template, if you use
2165:\f[V]-t ms\f[R], or the \f[V]default.html\f[R] template, if you use
2166:\f[V]-t html\f[R]).
2169:\f[V]--reference-doc\f[R] to customize the output).
2173:They may be set at the command line using the \f[V]-V/--variable\f[R]
2177:blocks or with the \f[V]-M/--metadata\f[R] option.
2191:Anything between the sequence \f[V]$--\f[R] and the end of the line will
2211:numbers, \f[V]_\f[R], \f[V]-\f[R], and \f[V].\f[R].
2322: - $foo.last$, $foo.first$
2326: - ${ foo.bar.last }, ${ foo.bar.first }
2352: - ${ it.last }, ${ it.first }
2522:|----------------------|------------|
2526:|----------------------|------------|
2601:---
2652:---
2687:---
2716:engine is fully supported (use \f[V]--pdf-engine=xelatex\f[R]).
2723:\f[V]pandoc --print-default-data-file=templates/styles.html\f[R]).
2724:Unless you use \f[V]--css\f[R], this variable is set to \f[V]true\f[R]
2726:You can disable it with e.g.\ \f[V]pandoc -M document-css=false\f[R].
2770:---
2786:---
2793:YAML metadata or with \f[V]-M classoption=fleqn\f[R].
2881:---
2885: beforeskip=-10pt plus -2pt minus -1pt,
2886: afterskip=1sp plus -1sp minus 1sp,
2889: beforeskip=-10pt plus -2pt minus -1pt,
2890: afterskip=1sp plus -1sp minus 1sp,
2905:---
2927:---
2944:---
2976:numbering depth for sections (with \f[V]--number-sections\f[R] option or
3002:---
3035:---
3091:\f[V]--toc/--table-of-contents\f[R])
3103:bibliography style, when used with \f[V]--natbib\f[R] and
3104:\f[V]--biblatex\f[R]
3107:bibliography title, when used with \f[V]--natbib\f[R] and
3108:\f[V]--biblatex\f[R]
3170:\f[V]--metadata=pdfa\f[R] or \f[V]pdfa: true\f[R] in a YAML metadata
3173:Using \f[V]--variable=pdfa\f[R] without specified value is not
3198:\f[V]--toc/--table-of-contents\f[R])
3215:The \f[V]--css\f[R] option also affects the output.
3306:contents specified by \f[V]-H/--include-in-header\f[R] (may have
3310:contents specified by \f[V]-B/--include-before-body\f[R] (may have
3314:contents specified by \f[V]-A/--include-after-body\f[R] (may have
3322:non-null value if \f[V]-N/--number-sections\f[R] was specified
3343:Similarly, \f[V]outputfile\f[R] can be \f[V]-\f[R] if output goes to the
3356:non-null value if \f[V]--toc/--table-of-contents\f[R] was specified
3367:name and disabled by adding \f[V]-EXTENSION\f[R].
3368:For example, \f[V]--from markdown_strict+footnotes\f[R] is strict
3370:\f[V]--from markdown-footnotes-pipe_tables\f[R] is pandoc\[cq]s Markdown
3382:\f[V]--markdown-headings\f[R]).
3386:Interpret straight quotes as curly quotes, \f[V]---\f[R] as em-dashes,
3387:\f[V]--\f[R] as en-dashes, and \f[V]...\f[R] as ellipses.
3412:and dashes (\f[V]--\f[R] for en-dash and \f[V]---\f[R] for em-dash).
3456:.RS -14n
3464: *Dogs*?--in *my* house? dogs--in-my-house
3476:the same identifier with \f[V]-1\f[R] appended; the third with
3477:\f[V]-2\f[R]; and so on.
3483:contents generated by the \f[V]--toc|--table-of-contents\f[R] option.
3498:If the \f[V]--section-divs\f[R] option is specified, then each section
3515:Spaces are converted to dashes (\f[V]-\f[R]), uppercase characters to
3516:lowercase characters, and punctuation characters other than \f[V]-\f[R]
3564:\f[V]-f html-native_divs+raw_html\f[R].
3569:\f[V]-f html-native_spans+raw_html\f[R].
3572:\f[V]pandoc -f html-native_divs-native_spans -t markdown\f[R].
3625:pandoc -f markdown+lhs -t html
3634:pandoc -f markdown+lhs -t html+lhs
3820:of \f[V]=\f[R] signs (for a level-one heading) or \f[V]-\f[R] signs (for
3918:if \f[V]--number-sections\f[R] is specified.
3919:A single hyphen (\f[V]-\f[R]) in an attribute context is equivalent to
3925:# My heading {-}
4162:\f[V]pandoc --list-highlight-languages\f[R].)
4226:To prevent all highlighting, use the \f[V]--no-highlight\f[R] flag.
4227:To set the highlighting style, use \f[V]--highlight-style\f[R].
4272:\f[V]-\f[R]).
4364: - macintosh
4365: - red delicious
4632:<!-- end of list -->
4647:<!-- -->
4656:A line containing a row of three or more \f[V]*\f[R], \f[V]-\f[R], or
4811:| Bananas | $1.34 | - built-in wrapper |
4812:| | | - bright color |
4814:| Oranges | $2.10 | - cures scurvy |
4815:| | | - tasty |
4832:| | min | -89.2 °C |
4851:| Antarctica | -89.2 | N/A | 19.8 |
4853:| Earth | -89.2 | 14 | 56.7 |
4882:use \f[V]=\f[R] instead of \f[V]-\f[R]:
4942:\f[V]--columns\f[R]), then the table will take up the full text width
4946:(For example \f[V]---|-\f[R] would make the first column 3/4 and the
5044:when the \f[V]--standalone\f[R] (\f[V]-s\f[R]) option is chosen.
5049:(\f[V]--title-prefix\f[R] or \f[V]-T\f[R] option).
5052:If a title prefix is specified with \f[V]-T\f[R] and no title block
5092:three hyphens (\f[V]---\f[R]) at the top and a line of three hyphens
5093:(\f[V]---\f[R]) or three dots (\f[V]...\f[R]) at the bottom.
5094:The initial line \f[V]---\f[R] must not be followed by a blank line.
5105:pandoc chap1.md chap2.md chap3.md metadata.yaml -s -o book.html
5109:Just be sure that the YAML file begins with \f[V]---\f[R] and ends with
5110:\f[V]---\f[R] or \f[V]...\f[R].
5111:Alternatively, you can use the \f[V]--metadata-file\f[R] option.
5134:When pandoc is used with \f[V]-t markdown\f[R] to create a Markdown
5136:\f[V]-s/--standalone\f[R] option is used.
5287:\[rs]\[ga]*_{}[]()>#+-.!
5299:\f[V]--ascii\f[R] command-line option to make it appear as an explicit
5534:For AsciiDoc output format (\f[V]-t asciidoc\f[R]) it will appear
5537:For AsciiDoctor output format (\f[V]-t asciidoctor\f[R]) the LaTeX
5560:If the \f[V]--mathml\f[R] flag is used, it will be rendered using MathML
5568:If the \f[V]--webtex\f[R] option is used, formulas are rendered as
5682:18--25 & 15 \[rs]\[rs]
5683:26--35 & 33 \[rs]\[rs]
5684:36--45 & 22 \[rs]\[rs] \[rs]hline
5737:\f[V]-t/--to\f[R], above, for a list, or use
5738:\f[V]pandoc --list-output-formats\f[R]).
5743:output (depending on what you use for \f[V]--pdf-engine\f[R]).
6025:\f[V]--dpi\f[R] option (by default, 96 dpi is assumed, unless the image
6213:(\f[V]:.#$%&-+?<>\[ti]/\f[R]), it must be surrounded by curly braces,
6220:In \f[V]\[at]Foo_bar--baz\f[R], the key is \f[V]Foo_bar\f[R] because the
6270:[\[at]smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
6275:A minus sign (\f[V]-\f[R]) before the \f[V]\[at]\f[R] will suppress
6281:Smith says blah [-\[at]smith04].
6337:pandoc chap*/*.md -f markdown+rebase_relative_paths
6401:\f[V]-\f[R] before a numeral is an en-dash, and \f[V]--\f[R] is an
6575:Using \f[V]--from=markdown+wikilinks_title_after_pipe\f[R] results in
6583:while using \f[V]--from=markdown+wikilinks_title_before_pipe\f[R]
6615:pandoc --list-extensions=FORMAT
6628:When the \f[V]--citeproc\f[R] option is used, pandoc can automatically
6634:pandoc --citeproc myinput.txt
6650:\f[V]--bibliography\f[R] command line argument.
6652:\f[V]--bibliography\f[R] arguments or set \f[V]bibliography\f[R]
6697:\f[V]--bibliography\f[R] or the YAML metadata field
6710: - family: Watson
6712: - family: Crick
6716: - - 1953
6717: - 4
6718: - 25
6743:pandoc chem.bib -s -f biblatex -t markdown
6744:pandoc chem.json -s -f csljson -t markdown
6752:pandoc chem.bib -s -f biblatex -t csljson
6753:pandoc chem.yaml -s -f markdown -t biblatex
6757:Running pandoc on a bibliography file with the \f[V]--citeproc\f[R]
6763:pandoc chem.bib -s --citeproc -o chem.html
6764:pandoc chem.bib -s --citeproc -o chem.pdf
6855:These files are specified using the \f[V]--csl\f[R] option or the
6864:The \f[V]--citation-abbreviations\f[R] option (or the
7004:\f[V]--natbib\f[R] or \f[V]--biblatex\f[R] argument to pandoc
7007:\f[V]--natbib\f[R]) or BibLaTeX (for \f[V]--biblatex\f[R]) format.
7035:The unicode extension syntax (after \f[V]-u-\f[R]) may be used to
7115:pandoc -t FORMAT -s habits.txt -o habits.html
7123:the \f[V]-s/--standalone\f[R] option embeds a link to JavaScript and CSS
7134:With all HTML slide formats, the \f[V]--self-contained\f[R] option can
7143:pandoc -t beamer habits.txt -o habits.pdf
7154:pandoc habits.txt -o habits.pptx
7164:This default can be overridden using the \f[V]--slide-level\f[R] option.
7196:\f[V]--slide-level=0\f[R].
7202:reveal.js unless you set \f[V]--slide-level=0\f[R] (which lets reveal.js
7245:\f[V]--reference-doc\f[R].
7250:a time), use the \f[V]-i\f[R] option.
7285:incrementally without the \f[V]-i\f[R] option and all at once with the
7286:\f[V]-i\f[R] option):
7290:> - Eat spaghetti
7291:> - Drink wine
7305:> - a
7306:> - list in a quote
7333:\f[V]$DATADIR\f[R] is the user data directory (see \f[V]--data-dir\f[R],
7352:Or you can specify a custom stylesheet using the \f[V]--css\f[R] option.
7356:\f[V]outertheme\f[R], using the \f[V]-V\f[R] option:
7360:pandoc -t beamer habits.txt -V theme:Warsaw -o habits.pdf
7577:EPUB metadata may be specified using the \f[V]--epub-metadata\f[R]
7740:.RS -14n
7804:(To see this, use \f[V]pandoc --print-default-data-file epub.css\f[R].)
7805:To use a different CSS file, just use the \f[V]--css\f[R] command line
7816:\f[V]pandoc -t chunkedhtml\f[R] will produce a zip archive of linked
7952:\f[V]-raw_html-raw_tex+raw_attribute\f[R] when translating between
7957:For example, \f[V]--wrap=preserve\f[R] will preserve soft line breaks in
7958:Markdown cells; \f[V]--markdown-headings=setext\f[R] will cause
7959:Setext-style headings to be used; and \f[V]--preserve-tabs\f[R] will
7969:\f[V]pandoc --list-highlight-languages\f[R].
7971:The color scheme can be selected using the \f[V]--highlight-style\f[R]
7977:\f[V]pandoc --list-highlight-styles\f[R].
7980:\f[V]--print-highlight-style\f[R] to generate a JSON \f[V].theme\f[R]
7982:\f[V]--highlight-style\f[R].
7987:pandoc --print-highlight-style pygments > my.theme
7995:pandoc --highlight-style my.theme
8001:\f[V]--syntax-definition\f[R] option to load a KDE-style XML syntax
8006:To disable highlighting, use the \f[V]--no-highlight\f[R] option.
8042:| A Bird came down the Walk---
8043:| He did not know I saw---
8073:(\f[V]-f docx+styles\f[R]), you can produce output that maintains the
8085:$ pandoc test/docx/custom-style-reference.docx -f docx -t markdown
8099:$ pandoc test/docx/custom-style-reference.docx -f docx+styles -t markdown
8132:pandoc -t data/sample.lua
8133:pandoc -f my_custom_markup_language.lua -t latex -s
8139:(see \f[V]--data-dir\f[R]).
8150:pandoc --print-default-data-file creole.lua
8163:If you want to use \f[V]--standalone\f[R] with a custom writer, you will
8164:need to specify a template manually using \f[V]--template\f[R] or add a
8221:pandoc --to=context+tagging -V pdfa=3a
8235:pandoc --pdf-engine=weasyprint \[rs]
8236: --pdf-engine-opt=--pdf-variant=pdf/ua-1 ...
8250:pandoc --pdf-engine=prince \[rs]
8251: --pdf-engine-opt=--tagged-pdf ...
8287:However, there is no REPL yet, and the \f[V]-i\f[R] option has no
8304:(Using the \f[V]--sandbox\f[R] option can protect against this threat.)
8307:\f[V]--self-contained\f[R], EPUB, Docx, and ODT) will embed encoded or
8311:(Using the \f[V]--sandbox\f[R] option can protect against this threat,
8319:(This corresponds to the use of the \f[V]--sandbox\f[R] option on the
8327:options \f[V]+RTS -M512M -RTS\f[R] (for example) to limit the heap size
-.-.
Find a repeated word
! 6355 --> with
-.-.
Strings longer than 3/4 of a standard line length (80)
Use "\:" to split the string at the end of an output line, for example a
long URLs (web address)
742 \f[V]--track-changes=accept\f[R]|\f[V]reject\f[R]|\f[V]all\f[R]
945 \f[V]--print-highlight-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
1003 \f[V]--request-header=\f[R]\f[I]NAME\f[R]\f[V]:\f[R]\f[I]VAL\f[R]
1064 \f[V]--reference-location=block\f[R]|\f[V]section\f[R]|\f[V]document\f[R]
1086 \f[V]--top-level-division=default\f[R]|\f[V]section\f[R]|\f[V]chapter\f[R]|\f[V]part\f[R]
1109 \f[V]--number-offset=\f[R]\f[I]NUMBER\f[R][\f[V],\f[R]\f[I]NUMBER\f[R]\f[V],\f[R]\f[I]\&...\f[R]]
1154 \f[V]--email-obfuscation=none\f[R]|\f[V]javascript\f[R]|\f[V]references\f[R]
3491 [heading identifiers](#heading-identifiers-in-html-latex-and-context).
4127 \[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
4131 \[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
4149 \[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
4748 -------------------------------------------------------------
4758 -------------------------------------------------------------
5233 \[rs]renewcommand{\[rs]section}[1]{\[rs]clearpage\[rs]oldsection{#1}}
6036 \f[V]\[rs]includegraphics[width=0.5\[rs]textwidth,height=\[rs]textheight]{file.jpg}\f[R]
6041 \f[V]\[rs]externalfigure[file.jpg][width=0.5\[rs]textwidth]\f[R]
-.-.
Add a comma (or \&) after "e.g." and "i.e.", or use English words
(man-pages(7)).
Abbreviation points should be protected against being interpreted as
an end of sentence, if they are not, and that independent of the
current place on the line.
5721:This can be useful to insert raw xml into \f[V]docx\f[R] documents, e.g.
6954:metadata field, e.g.
7216:This layout is used for what pandoc calls \[lq]title slides\[rq], i.e.
-.-.
Wrong distance between sentences in the input file (or a sentence ending
punctuation mark (for example '.' or '?') does not end a sentence, then
protect them with '\&' from being interpreted as such).
Separate the sentences and subordinate clauses; each begins on a new
line. See man-pages(7) ("Conventions for source file layout") and
"info groff" ("Input Conventions").
The best procedure is to always start a new sentence on a new line,
at least, if you are typing on a computer.
Remember coding: Only one command ("sentence") on each (logical) line.
E-mail: Easier to quote exactly the relevant lines.
Generally: Easier to edit the sentence.
Patches: Less unaffected text.
Search for two adjacent words is easier, when they belong to the same line,
and the same phrase.
The amount of space between sentences in the output can then be
controlled with the ".ss" request.
1762:- . # the working directory from which pandoc is run
2445: Oban whiskey. ($148)
2465: Oban whiskey. ($148)
2513:$it.key/alpha/uppercase$. $it.name$
2697:More text in English. [\[aq]Zitat auf Deutsch.\[aq]]{lang=de}
3301:(e.g.\ \f[V]Apr. 02, 2018\f[R] or
3464: *Dogs*?--in *my* house? dogs--in-my-house
3465: [HTML], [S5], or [RTF]? html-s5-or-rtf
3466: 3. Applications applications
4017:> This is a block quote. This
4020:> 1. This is a list inside a block quote.
4021:> 2. Second item.
4030:> This is a block quote. This
4033:> 1. This is a list inside a block quote.
4034:2. Second item.
4335: * Second paragraph. With a code block, which must be indented
4434:#. one
4435:#. two
4455: i. subone
4456: ii. subtwo
4457: iii. subthree
4755: Second row 5.0 Here\[aq]s another one. Note
4760:Table: Here\[aq]s the caption. It, too, may span
4788: Second row 5.0 Here\[aq]s another one. Note
6230:Blah blah [see \[at]doe99, pp. 33-35 and *passim*; \[at]smith04, chap. 1].
6236:The second item (\f[V]smith04\f[R]) has locator \f[V]chap. 1\f[R] and no
6270:[\[at]smith, {pp. iv, vi-xi, (xv)-(xvii)} with suffix here]
6292:\[at]smith04 [p. 33] says blah.
6711: given: J. D.
6713: given: F. H. C.
6894:Blah blah [\[at]foo, p. 33].
6905:Normal citations in footnotes (such as \f[V][\[at]foo, p. 33]\f[R]) will
6907:In-text citations (such as \f[V]\[at]foo [p. 33]\f[R]) will be rendered
6914:[\[ha]1]: Some studies [\[at]foo; \[at]bar, p. 33] show that
6916:of the literature, see \[at]baz [chap. 1].
7321:\&. . .
7868:**Lorem ipsum** dolor sit amet, consectetur adipiscing elit. Nunc luctus
7905:**Lorem ipsum** dolor sit amet, consectetur adipiscing elit. Nunc luctus
8088:This is text with an *emphasized* text style. And this is text with a
-.-.
Split lines longer than 80 characters into two or more lines.
Appropriate break points are the end of a sentence and a subordinate
clause; after punctuation marks.
N.B.
The number of lines affected can be too large to be in the patch.
Line 230, length 82
pandoc -f html -t markdown --request-header User-Agent:\[dq]Mozilla/5.0\[dq] \[rs]
Line 237, length 130
\f[V]-f\f[R] \f[I]FORMAT\f[R], \f[V]-r\f[R] \f[I]FORMAT\f[R], \f[V]--from=\f[R]\f[I]FORMAT\f[R], \f[V]--read=\f[R]\f[I]FORMAT\f[R]
Line 337, length 129
\f[V]-t\f[R] \f[I]FORMAT\f[R], \f[V]-w\f[R] \f[I]FORMAT\f[R], \f[V]--to=\f[R]\f[I]FORMAT\f[R], \f[V]--write=\f[R]\f[I]FORMAT\f[R]
Line 703, length 114
\f[V]-M\f[R] \f[I]KEY\f[R][\f[V]=\f[R]\f[I]VAL\f[R]], \f[V]--metadata=\f[R]\f[I]KEY\f[R][\f[V]:\f[R]\f[I]VAL\f[R]]
Line 813, length 114
\f[V]-V\f[R] \f[I]KEY\f[R][\f[V]=\f[R]\f[I]VAL\f[R]], \f[V]--variable=\f[R]\f[I]KEY\f[R][\f[V]:\f[R]\f[I]VAL\f[R]]
Line 838, length 82
\f[V]-D\f[R] \f[I]FORMAT\f[R], \f[V]--print-default-template=\f[R]\f[I]FORMAT\f[R]
Line 960, length 87
\f[V]-H\f[R] \f[I]FILE\f[R], \f[V]--include-in-header=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
Line 969, length 89
\f[V]-B\f[R] \f[I]FILE\f[R], \f[V]--include-before-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
Line 979, length 88
\f[V]-A\f[R] \f[I]FILE\f[R], \f[V]--include-after-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
Line 1086, length 89
\f[V]--top-level-division=default\f[R]|\f[V]section\f[R]|\f[V]chapter\f[R]|\f[V]part\f[R]
Line 1109, length 97
\f[V]--number-offset=\f[R]\f[I]NUMBER\f[R][\f[V],\f[R]\f[I]NUMBER\f[R]\f[V],\f[R]\f[I]\&...\f[R]]
Line 1213, length 83
\f[V]pandoc -o custom-reference.docx --print-default-data-file reference.docx\f[R].
Line 1315, length 81
\f[V]pandoc -o custom-reference.odt --print-default-data-file reference.odt\f[R].
Line 1355, length 83
\f[V]pandoc -o custom-reference.pptx --print-default-data-file reference.pptx\f[R],
Line 1869, length 85
--default-image-extension \[dq].jpg\[dq] default-image-extension: \[aq].jpg\[aq]
Line 1963, length 81
--resource-path .:foo resource-path: [\[aq].\[aq],\[aq]foo\[aq]]
Line 1967, length 81
- [\[dq]User-Agent\[dq], \[dq]Mozilla/5.0\[dq]]
Line 2036, length 81
--chunk-template=\[dq]%i.html\[dq] chunk-template: \[dq]%i.html\[dq]
Line 2038, length 81
--epub-subdirectory=\[dq]\[dq] epub-subdirectory: \[aq]\[aq]
Line 2524, length 98
$it.name.first/uppercase/left 20 \[dq]| \[dq]$$it.name.salary/right 10 \[dq] | \[dq] \[dq] |\[dq]$
Line 2761, length 92
\f[V]margin-left\f[R], \f[V]margin-right\f[R], \f[V]margin-top\f[R], \f[V]margin-bottom\f[R]
Line 2849, length 102
\f[V]theme\f[R], \f[V]colortheme\f[R], \f[V]fonttheme\f[R], \f[V]innertheme\f[R], \f[V]outertheme\f[R]
Line 2963, length 92
\f[V]margin-left\f[R], \f[V]margin-right\f[R], \f[V]margin-top\f[R], \f[V]margin-bottom\f[R]
Line 3018, length 147
\f[V]mainfont\f[R], \f[V]sansfont\f[R], \f[V]monofont\f[R], \f[V]mathfont\f[R], \f[V]CJKmainfont\f[R], \f[V]CJKsansfont\f[R], \f[V]CJKmonofont\f[R]
Line 3023, length 128
\f[V]mainfontoptions\f[R], \f[V]sansfontoptions\f[R], \f[V]monofontoptions\f[R], \f[V]mathfontoptions\f[R], \f[V]CJKoptions\f[R]
Line 3069, length 101
\f[V]linkcolor\f[R], \f[V]filecolor\f[R], \f[V]citecolor\f[R], \f[V]urlcolor\f[R], \f[V]toccolor\f[R]
Line 3154, length 92
\f[V]margin-left\f[R], \f[V]margin-right\f[R], \f[V]margin-top\f[R], \f[V]margin-bottom\f[R]
Line 3220, length 92
\f[V]margin-left\f[R], \f[V]margin-right\f[R], \f[V]margin-top\f[R], \f[V]margin-bottom\f[R]
Line 4149, length 245
\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]\[ti]
Line 4167, length 85
<pre id=\[dq]mycode\[dq] class=\[dq]haskell numberLines\[dq] startFrom=\[dq]100\[dq]>
Line 5991, length 81
[ref]: foo.jpg \[dq]optional title\[dq] {#id .class key=val key2=\[dq]val 2\[dq]}
Line 6036, length 88
\f[V]\[rs]includegraphics[width=0.5\[rs]textwidth,height=\[rs]textheight]{file.jpg}\f[R]
Line 6684, length 93
\f[V]<span style=\[dq]font-variant:small-caps;\[dq]>...</span>\f[R] or \f[V]<sc>...</sc>\f[R]
Line 7571, length 87
Slide 2 has a special image for its background, even though the heading has no content.
-.-.
Use \(en (en-dash) for a dash between space characters,
not a minus (\-) or a hyphen (-), except in the NAME section.
pandoc.1:20:pandoc - general markup converter
pandoc.1:1762:- . # the working directory from which pandoc is run
pandoc.1:1763:- ${.}/images # the images subdirectory of the directory
pandoc.1:1801: - foo.md
pandoc.1:1802: - bar.md
pandoc.1:1829: --output - output-file:
pandoc.1:1834: - file
pandoc.1:1866: --indented-code-classes python - python
pandoc.1:1874: - pandoc-citeproc
pandoc.1:1875: --lua-filter count-words.lua \[rs] - count-words.lua
pandoc.1:1876: --filter special.lua - type: json
pandoc.1:1884: - meta.yaml
pandoc.1:1950: --syntax-definition mylang.xml - mylang.xml
pandoc.1:1955: - inc.tex
pandoc.1:1958:--include-before-body inc.tex - inc.tex
pandoc.1:1961: - inc.tex
pandoc.1:1967: - [\[dq]User-Agent\[dq], \[dq]Mozilla/5.0\[dq]]
pandoc.1:2018: --css styles/special.css - styles/screen.css
pandoc.1:2019: - styles/special.css
pandoc.1:2030: --epub-embed-font special.otf \[rs] - special.otf
pandoc.1:2031: - headline.otf
pandoc.1:2045: --pdf-engine-opt=--shell-escape - \[aq]-shell-escape\[aq]
pandoc.1:2322: - $foo.last$, $foo.first$
pandoc.1:2326: - ${ foo.bar.last }, ${ foo.bar.first }
pandoc.1:2352: - ${ it.last }, ${ it.first }
pandoc.1:2501:- $it.key$: $it.value$
pandoc.1:2603:- Aristotle
pandoc.1:2604:- Peter Abelard
pandoc.1:2656:- Author One
pandoc.1:2657:- Author Two
pandoc.1:2907:- twocolumn
pandoc.1:2908:- landscape
pandoc.1:2929:- top=30mm
pandoc.1:2930:- left=20mm
pandoc.1:2931:- heightrounded
pandoc.1:2946:- linktoc=all
pandoc.1:2947:- pdfwindowui
pandoc.1:2948:- pdfpagemode=FullScreen
pandoc.1:3005:- osf
pandoc.1:3006:- p
pandoc.1:3038:- Numbers=Lowercase
pandoc.1:3039:- Numbers=Proportional
pandoc.1:4364: - macintosh
pandoc.1:4365: - red delicious
pandoc.1:4490:- [ ] an unchecked task list item
pandoc.1:4491:- [x] checked item
pandoc.1:4611:- item one
pandoc.1:4612:- item two
pandoc.1:4629:- item one
pandoc.1:4630:- item two
pandoc.1:4811:| Bananas | $1.34 | - built-in wrapper |
pandoc.1:4812:| | | - bright color |
pandoc.1:4814:| Oranges | $2.10 | - cures scurvy |
pandoc.1:4815:| | | - tasty |
pandoc.1:5154:- Author One
pandoc.1:5155:- Author Two
pandoc.1:5197:- name: Author One
pandoc.1:5199:- name: Author Two
pandoc.1:5230:- |
pandoc.1:6707:- type: article-journal
pandoc.1:6710: - family: Watson
pandoc.1:6712: - family: Crick
pandoc.1:6716: - - 1953
pandoc.1:6717: - 4
pandoc.1:6718: - 25
pandoc.1:7085:- Turn off alarm
pandoc.1:7086:- Get out of bed
pandoc.1:7090:- Eat eggs
pandoc.1:7091:- Drink coffee
pandoc.1:7097:- Eat spaghetti
pandoc.1:7098:- Drink wine
pandoc.1:7106:- Get in bed
pandoc.1:7107:- Count sheep
pandoc.1:7261:- Eat spaghetti
pandoc.1:7262:- Drink wine
pandoc.1:7274:- Eat spaghetti
pandoc.1:7275:- Drink wine
pandoc.1:7290:> - Eat spaghetti
pandoc.1:7291:> - Drink wine
pandoc.1:7305:> - a
pandoc.1:7306:> - list in a quote
pandoc.1:7382:- It can contain Markdown
pandoc.1:7383:- like this list
pandoc.1:7586:- type: main
pandoc.1:7588:- type: subtitle
pandoc.1:7591:- role: author
pandoc.1:7593:- role: editor
pandoc.1:7596:- scheme: DOI
-.-.
point size: the typographical term is 'type size'. There exist
several point sizes, like 'Didot point', 'big point' (PostScript point),
and 'pica point' (printer's point, English, USA).
3283:point size (e.g.\ \f[V]10p\f[R])
-.-.
Change a HYPHEN-MINUS (code 0x55, 2D) to a dash
(\-, minus) if it matches "[[:alph:]]-[[:alpha:]]" in the name of an
option).
Facilitates the copy and paste of an option in UTF-8 text.
Is not needed in ordinary words like "mother-in-law", that are not
copied and pasted to a command line (which needs ASCII code)
88:(Use \f[V]--file-scope\f[R] to parse files individually.)
114:You can also use \f[V]pandoc --list-input-formats\f[R] and
115:\f[V]pandoc --list-output-formats\f[R] to print lists of supported
163:a LaTeX engine be installed (see \f[V]--pdf-engine\f[R] below).
167:before, but add the \f[V]--pdf-engine\f[R] option or
171:specified using \f[V]--pdf-engine\f[R].
230:pandoc -f html -t markdown --request-header User-Agent:\[dq]Mozilla/5.0\[dq] \[rs]
333:See \f[V]--list-input-formats\f[R] and \f[V]--list-extensions\f[R],
472:See \f[V]--list-output-formats\f[R] and \f[V]--list-extensions\f[R],
487:\f[V]--data-dir=\f[R]\f[I]DIRECTORY\f[R]
515:\f[V]--data-dir\f[R]).
521:\f[V]--bash-completion\f[R]
529:eval \[dq]$(pandoc --bash-completion)\[dq]
540:\f[V]--fail-if-warnings\f[R]
548:\f[V]--list-input-formats\f[R]
551:\f[V]--list-output-formats\f[R]
554:\f[V]--list-extensions\f[R][\f[V]=\f[R]\f[I]FORMAT\f[R]]
561:\f[V]--list-highlight-languages\f[R]
564:\f[V]--list-highlight-styles\f[R]
566:See \f[V]--highlight-style\f[R].
575:\f[V]--shift-heading-level-by=\f[R]\f[I]NUMBER\f[R]
577:For example, with \f[V]--shift-heading-level-by=-1\f[R], level 2
584:\f[V]--shift-heading-level-by=-1\f[R] is a good choice when converting
587:\f[V]--shift-heading-level-by=1\f[R] may be a good choice for converting
591:\f[V]--base-header-level=\f[R]\f[I]NUMBER\f[R]
593:Use \f[VI]--shift-heading-level-by\f[I]=X instead, where X = NUMBER -
596:\f[V]--indented-code-classes=\f[R]\f[I]CLASSES\f[R]
601:\f[V]--default-image-extension=\f[R]\f[I]EXTENSION\f[R]
608:\f[V]--file-scope\f[R]
613:Reading binary files (docx, odt, epub) implies \f[V]--file-scope\f[R].
616:If two or more files are processed using \f[V]--file-scope\f[R],
667:\f[V]$DATADIR\f[R] is the user data directory (see \f[V]--data-dir\f[R],
676:\f[V]-L\f[R] \f[I]SCRIPT\f[R], \f[V]--lua-filter=\f[R]\f[I]SCRIPT\f[R]
697:directory (see \f[V]--data-dir\f[R], above).
716:\f[V]--metadata-file=\f[R]\f[I]FILE\f[R]
730:\f[V]--data-dir\f[R]).
732:\f[V]-p\f[R], \f[V]--preserve-tabs\f[R]
739:\f[V]--tab-stop=\f[R]\f[I]NUMBER\f[R]
742:\f[V]--track-changes=accept\f[R]|\f[V]reject\f[R]|\f[V]all\f[R]
762:\f[V]--extract-media=\f[R]\f[I]DIR\f[R]
779:\f[V]pandoc --print-default-data-file=abbreviations\f[R].
809:\f[V]--data-dir\f[R]).
811:output format will be used (see \f[V]-D/--print-default-template\f[R]).
838:\f[V]-D\f[R] \f[I]FORMAT\f[R], \f[V]--print-default-template=\f[R]\f[I]FORMAT\f[R]
844:\f[V]--print-default-template\f[R] on the command line.
849:To print the partials, use \f[V]--print-default-data-file\f[R]: for
850:example, \f[V]--print-default-data-file=templates/styles.html\f[R].
853:\f[V]--print-default-data-file=\f[R]\f[I]FILE\f[R]
858:\f[V]--print-default-data-file\f[R] on the command line.
894:\f[V]--toc\f[R], \f[V]--table-of-contents\f[R]
907:\f[V]--pdf-engine-opt=--no-toc-relocation\f[R].
910:\f[V]--toc-depth=\f[R]\f[I]NUMBER\f[R]
916:\f[V]--strip-comments\f[R]
922:\f[V]--no-highlight\f[R]
926:\f[V]--highlight-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
933:See also \f[V]--list-highlight-styles\f[R].
942:\f[V]--print-highlight-style\f[R].
945:\f[V]--print-highlight-style=\f[R]\f[I]STYLE\f[R]|\f[I]FILE\f[R]
948:\f[V]--highlight-style\f[R].
951:\f[V]--print-highlight-style\f[R] on the command line.
953:\f[V]--syntax-definition=\f[R]\f[I]FILE\f[R]
960:\f[V]-H\f[R] \f[I]FILE\f[R], \f[V]--include-in-header=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
969:\f[V]-B\f[R] \f[I]FILE\f[R], \f[V]--include-before-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
979:\f[V]-A\f[R] \f[I]FILE\f[R], \f[V]--include-after-body=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
987:\f[V]--resource-path=\f[R]\f[I]SEARCHPATH\f[R]
991:If \f[V]--resource-path\f[R] is not specified, the default resource path
993:Note that, if \f[V]--resource-path\f[R] is specified, the working
995:For example: \f[V]--resource-path=.:test\f[R] will search the working
1000:\f[V]--resource-path foo:bar --resource-path baz:bim\f[R] is equivalent
1001:to \f[V]--resource-path baz:bim:foo:bar\f[R].
1003:\f[V]--request-header=\f[R]\f[I]NAME\f[R]\f[V]:\f[R]\f[I]VAL\f[R]
1010:\f[V]--no-check-certificate\f[R]
1016:\f[V]--self-contained\f[R]
1018:\f[VI]--embed-resources --standalone\f[I].\f[R]
1020:\f[V]--embed-resources\f[R]
1044:\f[V]--html-q-tags\f[R]
1057:\f[V]--reference-links\f[R]
1062:\f[V]--reference-location\f[R] option.
1064:\f[V]--reference-location=block\f[R]|\f[V]section\f[R]|\f[V]document\f[R]
1073:In slide formats, specifying \f[V]--reference-location=section\f[R] will
1076:\f[V]--markdown-headings=setext\f[R]|\f[V]atx\f[R]
1083:\f[V]--list-tables\f[R]
1086:\f[V]--top-level-division=default\f[R]|\f[V]section\f[R]|\f[V]chapter\f[R]|\f[V]part\f[R]
1102:\f[V]-N\f[R], \f[V]--number-sections\f[R]
1107:\f[V]--number-sections\f[R] is specified.
1109:\f[V]--number-offset=\f[R]\f[I]NUMBER\f[R][\f[V],\f[R]\f[I]NUMBER\f[R]\f[V],\f[R]\f[I]\&...\f[R]]
1116:\f[V]--number-offset=5\f[R].
1118:numbered \[lq]1.5\[rq], specify \f[V]--number-offset=1,4\f[R].
1120:Implies \f[V]--number-sections\f[R].
1133:\f[V]--slide-level=\f[R]\f[I]NUMBER\f[R]
1148:\f[V]--section-divs\f[R]
1154:\f[V]--email-obfuscation=none\f[R]|\f[V]javascript\f[R]|\f[V]references\f[R]
1163:\f[V]--id-prefix=\f[R]\f[I]STRING\f[R]
1170:\f[V]-T\f[R] \f[I]STRING\f[R], \f[V]--title-prefix=\f[R]\f[I]STRING\f[R]
1190:\f[V]--data-dir\f[R]).
1194:\f[V]--reference-doc=\f[R]\f[I]FILE\f[R]|\f[I]URL\f[R]
1207:\f[V]--data-dir\f[R]).
1213:\f[V]pandoc -o custom-reference.docx --print-default-data-file reference.docx\f[R].
1309:\f[V]--data-dir\f[R]).
1315:\f[V]pandoc -o custom-reference.odt --print-default-data-file reference.odt\f[R].
1355:\f[V]pandoc -o custom-reference.pptx --print-default-data-file reference.pptx\f[R],
1361:\f[V]--split-level=\f[R]\f[I]NUMBER\f[R]
1373:\f[V]--chunk-template=\f[R]\f[I]PATHTEMPLATE\f[R]
1386:\f[V]--epub-chapter-level=\f[R]\f[I]NUMBER\f[R]
1387:\f[I]Deprecated synonym for \f[VI]--split-level\f[I].\f[R]
1389:\f[V]--epub-cover-image=\f[R]\f[I]FILE\f[R]
1397:\f[V]--epub-title-page=true\f[R]|\f[V]false\f[R]
1401:\f[V]--epub-metadata=\f[R]\f[I]FILE\f[R]
1428:\f[V]--epub-embed-font=\f[R]\f[I]FILE\f[R]
1470:\f[V]--epub-subdirectory=\f[R]\f[I]DIRNAME\f[R]
1476:\f[V]--ipynb-output=all|none|best\f[R]
1485:\f[V]--pdf-engine=\f[R]\f[I]PROGRAM\f[R]
1513:\f[V]--pdf-engine-opt=\f[R]\f[I]STRING\f[R]
1518:\f[V]--pdf-engine-opt=-outdir=foo\f[R].
1532:(If no stylesheet is specified, the \f[V]chicago-author-date\f[R] style
1535:filters or Lua filters (see \f[V]--filter\f[R], \f[V]--lua-filter\f[R]):
1547:will be sought in the resource path (see \f[V]--resource-path\f[R]).
1555:will be sought in the resource path (see \f[V]--resource-path\f[R]) and
1559:\f[V]--citation-abbreviations=\f[R]\f[I]FILE\f[R]
1566:will be sought in the resource path (see \f[V]--resource-path\f[R]) and
1649:\f[V]--dump-args\f[R]
1662:\f[V]--ignore-args\f[R]
1670:pandoc --ignore-args -o foo.html -s foo.txt -- -e latin1
1759:epub-cover-image: ${.}/cover.jpg
1782:(\f[V]--metadata-file\f[R], \f[V]--css\f[R],
1783:\f[V]--include-in-header\f[R], \f[V]--include-before-body\f[R],
1784:\f[V]--include-after-body\f[R], \f[V]--variable\f[R],
1785:\f[V]--metadata\f[R], \f[V]--syntax-definition\f[R]), the values
1831: --data-dir dir data-dir: dir
1840: --fail-if-warnings fail-if-warnings: true
1863: --shift-heading-level-by -1 shift-heading-level-by: -1
1865: indented-code-classes:
1866: --indented-code-classes python - python
1869: --default-image-extension \[dq].jpg\[dq] default-image-extension: \[aq].jpg\[aq]
1871: --file-scope file-scope: true
1875: --lua-filter count-words.lua \[rs] - count-words.lua
1883: --metadata-file meta.yaml metadata-files:
1888: --preserve-tabs preserve-tabs: true
1890: --tab-stop 8 tab-stop: 8
1892: --track-changes accept track-changes: accept
1894: --extract-media dir extract-media: dir
1937: --table-of-contents table-of-contents: true
1941: --toc-depth 3 toc-depth: 3
1943: --strip-comments strip-comments: true
1945: --no-highlight highlight-style: null
1947: --highlight-style kate highlight-style: kate
1950: --syntax-definition mylang.xml - mylang.xml
1954: --include-in-header inc.tex include-in-header:
1957: include-before-body:
1958:--include-before-body inc.tex - inc.tex
1960: --include-after-body inc.tex include-after-body:
1963: --resource-path .:foo resource-path: [\[aq].\[aq],\[aq]foo\[aq]]
1965: --request-header foo:bar request-headers:
1969: --no-check-certificate no-check-certificate: true
1982: --self-contained self-contained: true
1984: --html-q-tags html-q-tags: true
1988: --reference-links reference-links: true
1990: --reference-location block reference-location: block
1992: --markdown-headings atx markdown-headings: atx
1994: --list-tables list-tables: true
1996: --top-level-division chapter top-level-division: chapter
1998: --number-sections number-sections: true
2000: --number-offset=1,4 number-offset: \[rs][1,4\[rs]]
2006: --slide-level 2 slide-level: 2
2008: --section-divs section-divs: true
2011: --email-obfuscation references
2013: --id-prefix ch1 identifier-prefix: ch1
2015: --title-prefix MySite title-prefix: MySite
2021: --reference-doc my.docx reference-doc: my.docx
2023: --epub-cover-image cover.jpg epub-cover-image: cover.jpg
2025: --epub-title-page=false epub-title-page: false
2027: --epub-metadata meta.xml epub-metadata: meta.xml
2030: --epub-embed-font special.otf \[rs] - special.otf
2032: --epub-embed-font headline.otf
2034: --split-level 2 split-level: 2
2036: --chunk-template=\[dq]%i.html\[dq] chunk-template: \[dq]%i.html\[dq]
2038: --epub-subdirectory=\[dq]\[dq] epub-subdirectory: \[aq]\[aq]
2040: --ipynb-output best ipynb-output: best
2042: --pdf-engine xelatex pdf-engine: xelatex
2044: pdf-engine-opts:
2045: --pdf-engine-opt=--shell-escape - \[aq]-shell-escape\[aq]
2048: pdf-engine-opt: \[aq]-shell-escape\[aq]
2070: --citation-abbreviations ab.json
2098: --mathjax html-math-method:
2101: --mathml html-math-method:
2104: --webtex html-math-method:
2107: --katex html-math-method:
2110: --gladtex html-math-method:
2121:field can be added to \f[V]html-math-method:\f[R].
2130: --dump-args dump-args: true
2132: --ignore-args ignore-args: true
2156:\f[V]--data-dir\f[R], above).
2169:\f[V]--reference-doc\f[R] to customize the output).
2703:the base script direction, either \f[V]rtl\f[R] (right-to-left) or
2704:\f[V]ltr\f[R] (left-to-right).
2716:engine is fully supported (use \f[V]--pdf-engine=xelatex\f[R]).
2723:\f[V]pandoc --print-default-data-file=templates/styles.html\f[R]).
2815:\f[V]title-slide-attributes\f[R]
2976:numbering depth for sections (with \f[V]--number-sections\f[R] option or
3075:\f[V]links-as-notes\f[R]
3091:\f[V]--toc/--table-of-contents\f[R])
3198:\f[V]--toc/--table-of-contents\f[R])
3294:the \f[V]date\f[R] variable converted to ISO 8601 YYYY-MM-DD, included
3298:\f[V]mm/dd/yy\f[R], \f[V]yyyy-mm-dd\f[R] (ISO 8601),
3306:contents specified by \f[V]-H/--include-in-header\f[R] (may have
3310:contents specified by \f[V]-B/--include-before-body\f[R] (may have
3314:contents specified by \f[V]-A/--include-after-body\f[R] (may have
3322:non-null value if \f[V]-N/--number-sections\f[R] was specified
3356:non-null value if \f[V]--toc/--table-of-contents\f[R] was specified
3370:\f[V]--from markdown-footnotes-pipe_tables\f[R] is pandoc\[cq]s Markdown
3382:\f[V]--markdown-headings\f[R]).
3462: Heading identifiers in HTML heading-identifiers-in-html
3464: *Dogs*?--in *my* house? dogs--in-my-house
3465: [HTML], [S5], or [RTF]? html-s5-or-rtf
3483:contents generated by the \f[V]--toc|--table-of-contents\f[R] option.
3491:[heading identifiers](#heading-identifiers-in-html-latex-and-context).
3498:If the \f[V]--section-divs\f[R] option is specified, then each section
3739:\f[V]org-list-allow-alphabetical\f[R] in Emacs.
3918:if \f[V]--number-sections\f[R] is specified.
3982:[Heading identifiers in HTML](#heading-identifiers-in-html)
4162:\f[V]pandoc --list-highlight-languages\f[R].)
4226:To prevent all highlighting, use the \f[V]--no-highlight\f[R] flag.
4227:To set the highlighting style, use \f[V]--highlight-style\f[R].
5049:(\f[V]--title-prefix\f[R] or \f[V]-T\f[R] option).
5111:Alternatively, you can use the \f[V]--metadata-file\f[R] option.
5738:\f[V]pandoc --list-output-formats\f[R]).
5743:output (depending on what you use for \f[V]--pdf-engine\f[R]).
6285:You can also write an author-in-text citation, by omitting the square
6305:normal citations will be put in parentheses, while author-in-text
6307:For this reason, it is sometimes preferable to use the author-in-text
6615:pandoc --list-extensions=FORMAT
6864:The \f[V]--citation-abbreviations\f[R] option (or the
6901:\f[V]notes-after-punctuation\f[R], as described below in Other relevant
6936:\f[V]reference-section-title\f[R] in the metadata, or put the heading at
7039:\f[V]zh-u-co-pinyin\f[R] \[en] Chinese with the Pinyin collation.
7041:\f[V]es-u-co-trad\f[R] \[en] Spanish with the traditional collation
7044:\f[V]fr-u-kb\f[R] \[en] French with \[lq]backwards\[rq] accent sorting
7047:\f[V]en-US-u-kf-upper\f[R] \[en] English with uppercase letters sorting
7051:\f[V]notes-after-punctuation\f[R]
7134:With all HTML slide formats, the \f[V]--self-contained\f[R] option can
7164:This default can be overridden using the \f[V]--slide-level\f[R] option.
7196:\f[V]--slide-level=0\f[R].
7202:reveal.js unless you set \f[V]--slide-level=0\f[R] (which lets reveal.js
7231:This layout is used for any non-two-column slides which contain text
7245:\f[V]--reference-doc\f[R].
7333:\f[V]$DATADIR\f[R] is the user data directory (see \f[V]--data-dir\f[R],
7539:Note: \f[V]data-background-image\f[R] is also supported in pptx for
7541:found, \f[V]data-background-image\f[R] will be checked.
7545:reveal.js, use the \f[V]title-slide-attributes\f[R] variable in the YAML
7560:title-slide-attributes:
7561: data-background-image: /path/to/title_image.png
7562: data-background-size: contain
7577:EPUB metadata may be specified using the \f[V]--epub-metadata\f[R]
7635:A string value in \f[V]YYYY-MM-DD\f[R] format.
7672:\f[V]belongs-to-collection\f[R]
7680:the same \f[V]belongs-to-collection\f[R] field.
7688:\f[V]page-progression-direction\f[R]
7690:Specifies the \f[V]page-progression-direction\f[R] attribute for the
7702:\f[V]ipad-orientation-lock\f[R]:
7705:\f[V]iphone-orientation-lock\f[R]:
7804:(To see this, use \f[V]pandoc --print-default-data-file epub.css\f[R].)
7958:Markdown cells; \f[V]--markdown-headings=setext\f[R] will cause
7959:Setext-style headings to be used; and \f[V]--preserve-tabs\f[R] will
7969:\f[V]pandoc --list-highlight-languages\f[R].
7971:The color scheme can be selected using the \f[V]--highlight-style\f[R]
7977:\f[V]pandoc --list-highlight-styles\f[R].
7980:\f[V]--print-highlight-style\f[R] to generate a JSON \f[V].theme\f[R]
7982:\f[V]--highlight-style\f[R].
7987:pandoc --print-highlight-style pygments > my.theme
7995:pandoc --highlight-style my.theme
8001:\f[V]--syntax-definition\f[R] option to load a KDE-style XML syntax
8006:To disable highlighting, use the \f[V]--no-highlight\f[R] option.
8078:For example, using the \f[V]custom-style-reference.docx\f[R] file in the
8085:$ pandoc test/docx/custom-style-reference.docx -f docx -t markdown
8099:$ pandoc test/docx/custom-style-reference.docx -f docx+styles -t markdown
8139:(see \f[V]--data-dir\f[R]).
8150:pandoc --print-default-data-file creole.lua
8235:pandoc --pdf-engine=weasyprint \[rs]
8236: --pdf-engine-opt=--pdf-variant=pdf/ua-1 ...
8244:The non-free HTML-to-PDf converter \f[V]prince\f[R] has extensive
8250:pandoc --pdf-engine=prince \[rs]
8251: --pdf-engine-opt=--tagged-pdf ...
8307:\f[V]--self-contained\f[R], EPUB, Docx, and ODT) will embed encoded or
-.-.
Output from "test-groff -b -mandoc -rF0 -rHY=0 -K utf8 -t -ww -z ":
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':1686
troff:<stdin>:1686: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':1687
troff:<stdin>:1687: warning: treating -9000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':1791
troff:<stdin>:1791: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':1792
troff:<stdin>:1792: warning: treating -9000m indentation as zero
troff: backtrace: file '<stdin>':1796
troff:<stdin>:1796: warning: trailing space in the line
troff: backtrace: file '<stdin>':1798
troff:<stdin>:1798: warning: trailing space in the line
troff: backtrace: file '<stdin>':1800
troff:<stdin>:1800: warning: trailing space in the line
troff: backtrace: file '<stdin>':1801
troff:<stdin>:1801: warning: trailing space in the line
troff: backtrace: file '<stdin>':1802
troff:<stdin>:1802: warning: trailing space in the line
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':1811
troff:<stdin>:1811: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':1812
troff:<stdin>:1812: warning: treating -9000m indentation as zero
troff: backtrace: file '<stdin>':1816
troff:<stdin>:1816: warning: trailing space in the line
troff: backtrace: file '<stdin>':1818
troff:<stdin>:1818: warning: trailing space in the line
troff: backtrace: file '<stdin>':1820
troff:<stdin>:1820: warning: trailing space in the line
troff: backtrace: file '<stdin>':1822
troff:<stdin>:1822: warning: trailing space in the line
troff: backtrace: file '<stdin>':1823
troff:<stdin>:1823: warning: trailing space in the line
troff: backtrace: file '<stdin>':1825
troff:<stdin>:1825: warning: trailing space in the line
troff: backtrace: file '<stdin>':1827
troff:<stdin>:1827: warning: trailing space in the line
troff: backtrace: file '<stdin>':1829
troff:<stdin>:1829: warning: trailing space in the line
troff: backtrace: file '<stdin>':1831
troff:<stdin>:1831: warning: trailing space in the line
troff: backtrace: file '<stdin>':1833
troff:<stdin>:1833: warning: trailing space in the line
troff: backtrace: file '<stdin>':1834
troff:<stdin>:1834: warning: trailing space in the line
troff: backtrace: file '<stdin>':1836
troff:<stdin>:1836: warning: trailing space in the line
troff: backtrace: file '<stdin>':1838
troff:<stdin>:1838: warning: trailing space in the line
troff: backtrace: file '<stdin>':1840
troff:<stdin>:1840: warning: trailing space in the line
troff: backtrace: file '<stdin>':1842
troff:<stdin>:1842: warning: trailing space in the line
troff: backtrace: file '<stdin>':1844
troff:<stdin>:1844: warning: trailing space in the line
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':1856
troff:<stdin>:1856: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':1857
troff:<stdin>:1857: warning: treating -9000m indentation as zero
troff: backtrace: file '<stdin>':1861
troff:<stdin>:1861: warning: trailing space in the line
troff: backtrace: file '<stdin>':1863
troff:<stdin>:1863: warning: trailing space in the line
troff: backtrace: file '<stdin>':1865
troff:<stdin>:1865: warning: trailing space in the line
troff: backtrace: file '<stdin>':1866
troff:<stdin>:1866: warning: trailing space in the line
troff: backtrace: file '<stdin>':1869
troff:<stdin>:1869: warning: trailing space in the line
troff: backtrace: file '<stdin>':1871
troff:<stdin>:1871: warning: trailing space in the line
troff: backtrace: file '<stdin>':1873
troff:<stdin>:1873: warning: trailing space in the line
troff: backtrace: file '<stdin>':1874
troff:<stdin>:1874: warning: trailing space in the line
troff: backtrace: file '<stdin>':1875
troff:<stdin>:1875: warning: trailing space in the line
troff: backtrace: file '<stdin>':1876
troff:<stdin>:1876: warning: trailing space in the line
troff: backtrace: file '<stdin>':1877
troff:<stdin>:1877: warning: trailing space in the line
troff: backtrace: file '<stdin>':1879
troff:<stdin>:1879: warning: trailing space in the line
troff: backtrace: file '<stdin>':1880
troff:<stdin>:1880: warning: trailing space in the line
troff: backtrace: file '<stdin>':1881
troff:<stdin>:1881: warning: trailing space in the line
troff: backtrace: file '<stdin>':1883
troff:<stdin>:1883: warning: trailing space in the line
troff: backtrace: file '<stdin>':1884
troff:<stdin>:1884: warning: trailing space in the line
troff: backtrace: file '<stdin>':1886
troff:<stdin>:1886: warning: trailing space in the line
troff: backtrace: file '<stdin>':1888
troff:<stdin>:1888: warning: trailing space in the line
troff: backtrace: file '<stdin>':1890
troff:<stdin>:1890: warning: trailing space in the line
troff: backtrace: file '<stdin>':1892
troff:<stdin>:1892: warning: trailing space in the line
troff: backtrace: file '<stdin>':1894
troff:<stdin>:1894: warning: trailing space in the line
troff: backtrace: file '<stdin>':1896
troff:<stdin>:1896: warning: trailing space in the line
troff: backtrace: file '<stdin>':1898
troff:<stdin>:1898: warning: trailing space in the line
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':1914
troff:<stdin>:1914: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':1915
troff:<stdin>:1915: warning: treating -9000m indentation as zero
troff: backtrace: file '<stdin>':1919
troff:<stdin>:1919: warning: trailing space in the line
troff: backtrace: file '<stdin>':1921
troff:<stdin>:1921: warning: trailing space in the line
troff: backtrace: file '<stdin>':1923
troff:<stdin>:1923: warning: trailing space in the line
troff: backtrace: file '<stdin>':1925
troff:<stdin>:1925: warning: trailing space in the line
troff: backtrace: file '<stdin>':1926
troff:<stdin>:1926: warning: trailing space in the line
troff: backtrace: file '<stdin>':1927
troff:<stdin>:1927: warning: trailing space in the line
troff: backtrace: file '<stdin>':1929
troff:<stdin>:1929: warning: trailing space in the line
troff: backtrace: file '<stdin>':1931
troff:<stdin>:1931: warning: trailing space in the line
troff: backtrace: file '<stdin>':1933
troff:<stdin>:1933: warning: trailing space in the line
troff: backtrace: file '<stdin>':1935
troff:<stdin>:1935: warning: trailing space in the line
troff: backtrace: file '<stdin>':1937
troff:<stdin>:1937: warning: trailing space in the line
troff: backtrace: file '<stdin>':1939
troff:<stdin>:1939: warning: trailing space in the line
troff: backtrace: file '<stdin>':1941
troff:<stdin>:1941: warning: trailing space in the line
troff: backtrace: file '<stdin>':1943
troff:<stdin>:1943: warning: trailing space in the line
troff: backtrace: file '<stdin>':1945
troff:<stdin>:1945: warning: trailing space in the line
troff: backtrace: file '<stdin>':1947
troff:<stdin>:1947: warning: trailing space in the line
troff: backtrace: file '<stdin>':1949
troff:<stdin>:1949: warning: trailing space in the line
troff: backtrace: file '<stdin>':1950
troff:<stdin>:1950: warning: trailing space in the line
troff: backtrace: file '<stdin>':1952
troff:<stdin>:1952: warning: trailing space in the line
troff: backtrace: file '<stdin>':1954
troff:<stdin>:1954: warning: trailing space in the line
troff: backtrace: file '<stdin>':1955
troff:<stdin>:1955: warning: trailing space in the line
troff: backtrace: file '<stdin>':1957
troff:<stdin>:1957: warning: trailing space in the line
troff: backtrace: file '<stdin>':1958
troff:<stdin>:1958: warning: trailing space in the line
troff: backtrace: file '<stdin>':1960
troff:<stdin>:1960: warning: trailing space in the line
troff: backtrace: file '<stdin>':1961
troff:<stdin>:1961: warning: trailing space in the line
troff: backtrace: file '<stdin>':1963
troff:<stdin>:1963: warning: trailing space in the line
troff: backtrace: file '<stdin>':1965
troff:<stdin>:1965: warning: trailing space in the line
troff: backtrace: file '<stdin>':1967
troff:<stdin>:1967: warning: trailing space in the line
troff: backtrace: file '<stdin>':1969
troff:<stdin>:1969: warning: trailing space in the line
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':1975
troff:<stdin>:1975: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':1976
troff:<stdin>:1976: warning: treating -9000m indentation as zero
troff: backtrace: file '<stdin>':1980
troff:<stdin>:1980: warning: trailing space in the line
troff: backtrace: file '<stdin>':1982
troff:<stdin>:1982: warning: trailing space in the line
troff: backtrace: file '<stdin>':1984
troff:<stdin>:1984: warning: trailing space in the line
troff: backtrace: file '<stdin>':1986
troff:<stdin>:1986: warning: trailing space in the line
troff: backtrace: file '<stdin>':1988
troff:<stdin>:1988: warning: trailing space in the line
troff: backtrace: file '<stdin>':1990
troff:<stdin>:1990: warning: trailing space in the line
troff: backtrace: file '<stdin>':1992
troff:<stdin>:1992: warning: trailing space in the line
troff: backtrace: file '<stdin>':1994
troff:<stdin>:1994: warning: trailing space in the line
troff: backtrace: file '<stdin>':1996
troff:<stdin>:1996: warning: trailing space in the line
troff: backtrace: file '<stdin>':1998
troff:<stdin>:1998: warning: trailing space in the line
troff: backtrace: file '<stdin>':2000
troff:<stdin>:2000: warning: trailing space in the line
troff: backtrace: file '<stdin>':2002
troff:<stdin>:2002: warning: trailing space in the line
troff: backtrace: file '<stdin>':2004
troff:<stdin>:2004: warning: trailing space in the line
troff: backtrace: file '<stdin>':2006
troff:<stdin>:2006: warning: trailing space in the line
troff: backtrace: file '<stdin>':2008
troff:<stdin>:2008: warning: trailing space in the line
troff: backtrace: file '<stdin>':2010
troff:<stdin>:2010: warning: trailing space in the line
troff: backtrace: file '<stdin>':2011
troff:<stdin>:2011: warning: trailing space in the line
troff: backtrace: file '<stdin>':2013
troff:<stdin>:2013: warning: trailing space in the line
troff: backtrace: file '<stdin>':2015
troff:<stdin>:2015: warning: trailing space in the line
troff: backtrace: file '<stdin>':2017
troff:<stdin>:2017: warning: trailing space in the line
troff: backtrace: file '<stdin>':2018
troff:<stdin>:2018: warning: trailing space in the line
troff: backtrace: file '<stdin>':2019
troff:<stdin>:2019: warning: trailing space in the line
troff: backtrace: file '<stdin>':2021
troff:<stdin>:2021: warning: trailing space in the line
troff: backtrace: file '<stdin>':2023
troff:<stdin>:2023: warning: trailing space in the line
troff: backtrace: file '<stdin>':2025
troff:<stdin>:2025: warning: trailing space in the line
troff: backtrace: file '<stdin>':2027
troff:<stdin>:2027: warning: trailing space in the line
troff: backtrace: file '<stdin>':2029
troff:<stdin>:2029: warning: trailing space in the line
troff: backtrace: file '<stdin>':2030
troff:<stdin>:2030: warning: trailing space in the line
troff: backtrace: file '<stdin>':2031
troff:<stdin>:2031: warning: trailing space in the line
troff: backtrace: file '<stdin>':2032
troff:<stdin>:2032: warning: trailing space in the line
troff: backtrace: file '<stdin>':2034
troff:<stdin>:2034: warning: trailing space in the line
troff: backtrace: file '<stdin>':2036
troff:<stdin>:2036: warning: trailing space in the line
troff: backtrace: file '<stdin>':2038
troff:<stdin>:2038: warning: trailing space in the line
troff: backtrace: file '<stdin>':2040
troff:<stdin>:2040: warning: trailing space in the line
troff: backtrace: file '<stdin>':2042
troff:<stdin>:2042: warning: trailing space in the line
troff: backtrace: file '<stdin>':2044
troff:<stdin>:2044: warning: trailing space in the line
troff: backtrace: file '<stdin>':2045
troff:<stdin>:2045: warning: trailing space in the line
troff: backtrace: file '<stdin>':2048
troff:<stdin>:2048: warning: trailing space in the line
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':2054
troff:<stdin>:2054: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':2055
troff:<stdin>:2055: warning: treating -9000m indentation as zero
troff: backtrace: file '<stdin>':2059
troff:<stdin>:2059: warning: trailing space in the line
troff: backtrace: file '<stdin>':2061
troff:<stdin>:2061: warning: trailing space in the line
troff: backtrace: file '<stdin>':2063
troff:<stdin>:2063: warning: trailing space in the line
troff: backtrace: file '<stdin>':2064
troff:<stdin>:2064: warning: trailing space in the line
troff: backtrace: file '<stdin>':2066
troff:<stdin>:2066: warning: trailing space in the line
troff: backtrace: file '<stdin>':2067
troff:<stdin>:2067: warning: trailing space in the line
troff: backtrace: file '<stdin>':2069
troff:<stdin>:2069: warning: trailing space in the line
troff: backtrace: file '<stdin>':2070
troff:<stdin>:2070: warning: trailing space in the line
troff: backtrace: file '<stdin>':2071
troff:<stdin>:2071: warning: trailing space in the line
troff: backtrace: file '<stdin>':2073
troff:<stdin>:2073: warning: trailing space in the line
troff: backtrace: file '<stdin>':2075
troff:<stdin>:2075: warning: trailing space in the line
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':2091
troff:<stdin>:2091: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':2092
troff:<stdin>:2092: warning: treating -9000m indentation as zero
troff: backtrace: file '<stdin>':2096
troff:<stdin>:2096: warning: trailing space in the line
troff: backtrace: file '<stdin>':2098
troff:<stdin>:2098: warning: trailing space in the line
troff: backtrace: file '<stdin>':2099
troff:<stdin>:2099: warning: trailing space in the line
troff: backtrace: file '<stdin>':2101
troff:<stdin>:2101: warning: trailing space in the line
troff: backtrace: file '<stdin>':2102
troff:<stdin>:2102: warning: trailing space in the line
troff: backtrace: file '<stdin>':2104
troff:<stdin>:2104: warning: trailing space in the line
troff: backtrace: file '<stdin>':2105
troff:<stdin>:2105: warning: trailing space in the line
troff: backtrace: file '<stdin>':2107
troff:<stdin>:2107: warning: trailing space in the line
troff: backtrace: file '<stdin>':2108
troff:<stdin>:2108: warning: trailing space in the line
troff: backtrace: file '<stdin>':2110
troff:<stdin>:2110: warning: trailing space in the line
troff: backtrace: file '<stdin>':2111
troff:<stdin>:2111: warning: trailing space in the line
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':2123
troff:<stdin>:2123: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':2124
troff:<stdin>:2124: warning: treating -9000m indentation as zero
troff: backtrace: file '<stdin>':2128
troff:<stdin>:2128: warning: trailing space in the line
troff: backtrace: file '<stdin>':2130
troff:<stdin>:2130: warning: trailing space in the line
troff: backtrace: file '<stdin>':2132
troff:<stdin>:2132: warning: trailing space in the line
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':3456
troff:<stdin>:3456: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':3457
troff:<stdin>:3457: warning: treating -9000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':6655
troff:<stdin>:6655: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':6656
troff:<stdin>:6656: warning: treating -9000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':728: macro 'RS'
troff: backtrace: file '<stdin>':7740
troff:<stdin>:7740: warning: treating -20000m indentation as zero
troff: backtrace: '/home/bg/git/groff/build/s-tmac/an.tmac':607: macro 'IP'
troff: backtrace: file '<stdin>':7741
troff:<stdin>:7741: warning: treating -9000m indentation as zero
--- pandoc.1 2024-09-19 08:57:38.793268224 +0000
+++ pandoc.1.new 2024-10-07 14:09:39.178960975 +0000
@@ -2,6 +2,21 @@
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
+.if \n(.g \{\
+.ie !F CB \{\
+. ftr V B
+. ftr VI BI
+. ftr VB B
+. ftr VBI BI
+.\}
+.el \{\
+. ftr V CR
+. ftr VI CI
+. ftr VB CB
+. ftr VBI CBI
+.\}
+.\}
+.if !\n(.g \{\
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
@@ -14,6 +29,7 @@
. ftr VB CB
. ftr VBI CBI
.\}
+.\}
.TH "Pandoc User\[cq]s Guide" "" "June 6, 2023" "pandoc 3.1.3" ""
.hy
.SH NAME
@@ -1683,7 +1699,7 @@ pandoc -o foo.html -s
.PP
If pandoc completes successfully, it will return exit code 0.
Nonzero exit codes have the following meanings:
-.RS -14n
+.RS\" -14n
.IP
.nf
\f[C]
@@ -1788,18 +1804,18 @@ defaults file, rather than replacing the
.PP
The following tables show the mapping between the command line and
defaults file entries.
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
- command line defaults file
+ command line defaults file
--------------------------------- ----------------------------------
- foo.md input-file: foo.md
+ foo.md input-file: foo.md
- foo.md bar.md input-files:
- - foo.md
- - bar.md
+ foo.md bar.md input-files:
+ - foo.md
+ - bar.md
\f[R]
.fi
@@ -1808,40 +1824,40 @@ defaults file entries.
The value of \f[V]input-files\f[R] may be left empty to indicate input
from stdin, and it can be an empty sequence \f[V][]\f[R] for no input.
.SS General options
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
- command line defaults file
+ command line defaults file
--------------------------------- ----------------------------------
- --from markdown+emoji from: markdown+emoji
-
- reader: markdown+emoji
+ --from markdown+emoji from: markdown+emoji
- to: markdown+hard_line_breaks
- --to markdown+hard_line_breaks
-
- writer: markdown+hard_line_breaks
+ reader: markdown+emoji
- --output foo.pdf output-file: foo.pdf
+ to: markdown+hard_line_breaks
+ --to markdown+hard_line_breaks
- --output - output-file:
+ writer: markdown+hard_line_breaks
- --data-dir dir data-dir: dir
+ --output foo.pdf output-file: foo.pdf
- --defaults file defaults:
- - file
+ --output - output-file:
- --verbose verbosity: INFO
+ --data-dir dir data-dir: dir
- --quiet verbosity: ERROR
+ --defaults file defaults:
+ - file
- --fail-if-warnings fail-if-warnings: true
+ --verbose verbosity: INFO
- --sandbox sandbox: true
+ --quiet verbosity: ERROR
- --log=FILE log-file: FILE
+ --fail-if-warnings fail-if-warnings: true
+
+ --sandbox sandbox: true
+
+ --log=FILE log-file: FILE
\f[R]
.fi
@@ -1853,49 +1869,49 @@ those in another file included with a \f
\f[V]verbosity\f[R] can have the values \f[V]ERROR\f[R],
\f[V]WARNING\f[R], or \f[V]INFO\f[R].
.SS Reader options
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
- command line defaults file
+ command line defaults file
--------------------------------- ----------------------------------
- --shift-heading-level-by -1 shift-heading-level-by: -1
+ --shift-heading-level-by -1 shift-heading-level-by: -1
- indented-code-classes:
- --indented-code-classes python - python
+ indented-code-classes:
+ --indented-code-classes python - python
-
- --default-image-extension \[dq].jpg\[dq] default-image-extension: \[aq].jpg\[aq]
- --file-scope file-scope: true
+ --default-image-extension \[dq].jpg\[dq] default-image-extension: \[aq].jpg\[aq]
- --filter pandoc-citeproc \[rs] filters:
- - pandoc-citeproc
- --lua-filter count-words.lua \[rs] - count-words.lua
- --filter special.lua - type: json
- path: special.lua
+ --file-scope file-scope: true
- --metadata key=value \[rs] metadata:
- --metadata key2 key: value
- key2: true
+ --filter pandoc-citeproc \[rs] filters:
+ - pandoc-citeproc
+ --lua-filter count-words.lua \[rs] - count-words.lua
+ --filter special.lua - type: json
+ path: special.lua
- --metadata-file meta.yaml metadata-files:
- - meta.yaml
-
- metadata-file: meta.yaml
+ --metadata key=value \[rs] metadata:
+ --metadata key2 key: value
+ key2: true
- --preserve-tabs preserve-tabs: true
+ --metadata-file meta.yaml metadata-files:
+ - meta.yaml
- --tab-stop 8 tab-stop: 8
+ metadata-file: meta.yaml
- --track-changes accept track-changes: accept
+ --preserve-tabs preserve-tabs: true
- --extract-media dir extract-media: dir
+ --tab-stop 8 tab-stop: 8
- --abbreviations abbrevs.txt abbreviations: abbrevs.txt
+ --track-changes accept track-changes: accept
- --trace trace: true
+ --extract-media dir extract-media: dir
+
+ --abbreviations abbrevs.txt abbreviations: abbrevs.txt
+
+ --trace trace: true
\f[R]
.fi
@@ -1911,168 +1927,168 @@ Filters are run in the order specified.
To include the built-in citeproc filter, use either \f[V]citeproc\f[R]
or \f[V]{type: citeproc}\f[R].
.SS General writer options
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
- command line defaults file
+ command line defaults file
--------------------------------- ----------------------------------
- --standalone standalone: true
+ --standalone standalone: true
- --template letter template: letter
+ --template letter template: letter
- --variable key=val \[rs] variables:
- --variable key2 key: val
- key2: true
+ --variable key=val \[rs] variables:
+ --variable key2 key: val
+ key2: true
- --eol nl eol: nl
+ --eol nl eol: nl
- --dpi 300 dpi: 300
+ --dpi 300 dpi: 300
- --wrap 60 wrap: 60
+ --wrap 60 wrap: 60
- --columns 72 columns: 72
+ --columns 72 columns: 72
- --table-of-contents table-of-contents: true
+ --table-of-contents table-of-contents: true
- --toc toc: true
+ --toc toc: true
- --toc-depth 3 toc-depth: 3
+ --toc-depth 3 toc-depth: 3
- --strip-comments strip-comments: true
+ --strip-comments strip-comments: true
- --no-highlight highlight-style: null
+ --no-highlight highlight-style: null
- --highlight-style kate highlight-style: kate
+ --highlight-style kate highlight-style: kate
- syntax-definitions:
- --syntax-definition mylang.xml - mylang.xml
-
- syntax-definition: mylang.xml
+ syntax-definitions:
+ --syntax-definition mylang.xml - mylang.xml
- --include-in-header inc.tex include-in-header:
- - inc.tex
+ syntax-definition: mylang.xml
- include-before-body:
---include-before-body inc.tex - inc.tex
+ --include-in-header inc.tex include-in-header:
+ - inc.tex
- --include-after-body inc.tex include-after-body:
- - inc.tex
+ include-before-body:
+--include-before-body inc.tex - inc.tex
- --resource-path .:foo resource-path: [\[aq].\[aq],\[aq]foo\[aq]]
+ --include-after-body inc.tex include-after-body:
+ - inc.tex
- --request-header foo:bar request-headers:
-
- - [\[dq]User-Agent\[dq], \[dq]Mozilla/5.0\[dq]]
+ --resource-path .:foo resource-path: [\[aq].\[aq],\[aq]foo\[aq]]
- --no-check-certificate no-check-certificate: true
+ --request-header foo:bar request-headers:
+
+ - [\[dq]User-Agent\[dq], \[dq]Mozilla/5.0\[dq]]
+
+ --no-check-certificate no-check-certificate: true
\f[R]
.fi
.RE
.SS Options affecting specific writers
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
- command line defaults file
+ command line defaults file
--------------------------------- ----------------------------------
- --self-contained self-contained: true
+ --self-contained self-contained: true
- --html-q-tags html-q-tags: true
+ --html-q-tags html-q-tags: true
- --ascii ascii: true
+ --ascii ascii: true
- --reference-links reference-links: true
+ --reference-links reference-links: true
- --reference-location block reference-location: block
+ --reference-location block reference-location: block
- --markdown-headings atx markdown-headings: atx
+ --markdown-headings atx markdown-headings: atx
- --list-tables list-tables: true
+ --list-tables list-tables: true
- --top-level-division chapter top-level-division: chapter
+ --top-level-division chapter top-level-division: chapter
- --number-sections number-sections: true
+ --number-sections number-sections: true
- --number-offset=1,4 number-offset: \[rs][1,4\[rs]]
+ --number-offset=1,4 number-offset: \[rs][1,4\[rs]]
- --listings listings: true
+ --listings listings: true
- --incremental incremental: true
+ --incremental incremental: true
- --slide-level 2 slide-level: 2
+ --slide-level 2 slide-level: 2
- --section-divs section-divs: true
+ --section-divs section-divs: true
- email-obfuscation: references
- --email-obfuscation references
+ email-obfuscation: references
+ --email-obfuscation references
- --id-prefix ch1 identifier-prefix: ch1
+ --id-prefix ch1 identifier-prefix: ch1
- --title-prefix MySite title-prefix: MySite
+ --title-prefix MySite title-prefix: MySite
- --css styles/screen.css \[rs] css:
- --css styles/special.css - styles/screen.css
- - styles/special.css
+ --css styles/screen.css \[rs] css:
+ --css styles/special.css - styles/screen.css
+ - styles/special.css
- --reference-doc my.docx reference-doc: my.docx
+ --reference-doc my.docx reference-doc: my.docx
- --epub-cover-image cover.jpg epub-cover-image: cover.jpg
+ --epub-cover-image cover.jpg epub-cover-image: cover.jpg
- --epub-title-page=false epub-title-page: false
+ --epub-title-page=false epub-title-page: false
- --epub-metadata meta.xml epub-metadata: meta.xml
+ --epub-metadata meta.xml epub-metadata: meta.xml
- epub-fonts:
- --epub-embed-font special.otf \[rs] - special.otf
- - headline.otf
- --epub-embed-font headline.otf
+ epub-fonts:
+ --epub-embed-font special.otf \[rs] - special.otf
+ - headline.otf
+ --epub-embed-font headline.otf
- --split-level 2 split-level: 2
+ --split-level 2 split-level: 2
- --chunk-template=\[dq]%i.html\[dq] chunk-template: \[dq]%i.html\[dq]
+ --chunk-template=\[dq]%i.html\[dq] chunk-template: \[dq]%i.html\[dq]
- --epub-subdirectory=\[dq]\[dq] epub-subdirectory: \[aq]\[aq]
+ --epub-subdirectory=\[dq]\[dq] epub-subdirectory: \[aq]\[aq]
- --ipynb-output best ipynb-output: best
+ --ipynb-output best ipynb-output: best
- --pdf-engine xelatex pdf-engine: xelatex
+ --pdf-engine xelatex pdf-engine: xelatex
+
+ pdf-engine-opts:
+ --pdf-engine-opt=--shell-escape - \[aq]-shell-escape\[aq]
- pdf-engine-opts:
- --pdf-engine-opt=--shell-escape - \[aq]-shell-escape\[aq]
-
-
- pdf-engine-opt: \[aq]-shell-escape\[aq]
+
+ pdf-engine-opt: \[aq]-shell-escape\[aq]
\f[R]
.fi
.RE
.SS Citation rendering
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
- command line defaults file
+ command line defaults file
--------------------------------- ----------------------------------
- --citeproc citeproc: true
+ --citeproc citeproc: true
- --bibliography logic.bib metadata:
- bibliography: logic.bib
+ --bibliography logic.bib metadata:
+ bibliography: logic.bib
- --csl ieee.csl metadata:
- csl: ieee.csl
+ --csl ieee.csl metadata:
+ csl: ieee.csl
- metadata:
- --citation-abbreviations ab.json
- citation-abbreviations: ab.json
+ metadata:
+ --citation-abbreviations ab.json
+ citation-abbreviations: ab.json
- --natbib cite-method: natbib
+ --natbib cite-method: natbib
- --biblatex cite-method: biblatex
+ --biblatex cite-method: biblatex
\f[R]
.fi
@@ -2088,27 +2104,27 @@ If you need control over when the citepr
to other filters, you should instead use \f[V]citeproc\f[R] in the list
of \f[V]filters\f[R] (see above).
.SS Math rendering in HTML
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
- command line defaults file
+ command line defaults file
--------------------------------- ----------------------------------
- --mathjax html-math-method:
- method: mathjax
+ --mathjax html-math-method:
+ method: mathjax
- --mathml html-math-method:
- method: mathml
+ --mathml html-math-method:
+ method: mathml
- --webtex html-math-method:
- method: webtex
+ --webtex html-math-method:
+ method: webtex
- --katex html-math-method:
- method: katex
+ --katex html-math-method:
+ method: katex
- --gladtex html-math-method:
- method: gladtex
+ --gladtex html-math-method:
+ method: gladtex
\f[R]
.fi
@@ -2120,16 +2136,16 @@ value \f[V]plain\f[R].
If the command line option accepts a URL argument, an \f[V]url:\f[R]
field can be added to \f[V]html-math-method:\f[R].
.SS Options for wrapper scripts
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
- command line defaults file
+ command line defaults file
--------------------------------- ----------------------------------
- --dump-args dump-args: true
+ --dump-args dump-args: true
- --ignore-args ignore-args: true
+ --ignore-args ignore-args: true
\f[R]
.fi
@@ -3453,7 +3469,7 @@ a number or punctuation mark).
If nothing is left after this, use the identifier \f[V]section\f[R].
.PP
Thus, for example,
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
@@ -6652,7 +6668,7 @@ If you want to use multiple bibliography
\f[V]--bibliography\f[R] arguments or set \f[V]bibliography\f[R]
metadata field to YAML array.
A bibliography may have any of these formats:
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
@@ -7737,7 +7753,7 @@ Which will result in:
Pandoc will output \f[V]<body epub:type=\[dq]bodymatter\[dq]>\f[R],
unless you use one of the following values, in which case either
\f[V]frontmatter\f[R] or \f[V]backmatter\f[R] will be output.
-.RS -14n
+.RS\"-14n
.IP
.nf
\f[C]
Reply to: