diff options
| author | John MacFarlane <[email protected]> | 2023-06-06 17:50:17 -0700 |
|---|---|---|
| committer | John MacFarlane <[email protected]> | 2023-06-06 17:50:17 -0700 |
| commit | 72a85ac6ab70759c91fff9ceffef82a47e16a755 (patch) | |
| tree | 8c6d9a6ac1babce7a3b5b8ebac0fe26722fe8ff0 /man | |
| parent | 3975064e121e70bc19f1e24c290858b70374aaca (diff) | |
Update manual date and man page.
Diffstat (limited to 'man')
| -rw-r--r-- | man/pandoc.1 | 82 |
1 files changed, 57 insertions, 25 deletions
diff --git a/man/pandoc.1 b/man/pandoc.1 index ab2afb7b1..f423b08c9 100644 --- a/man/pandoc.1 +++ b/man/pandoc.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pandoc 3.0.1 +.\" Automatically generated by Pandoc 3.1.2 .\" .\" Define V font for inline verbatim, using C font in formats .\" that render this, and otherwise B font. @@ -14,7 +14,7 @@ . ftr VB CB . ftr VBI CBI .\} -.TH "Pandoc User\[cq]s Guide" "" "March 26, 2023" "pandoc 3.1.2" "" +.TH "Pandoc User\[cq]s Guide" "" "June 6, 2023" "pandoc 3.1.3" "" .hy .SH NAME pandoc - general markup converter @@ -321,6 +321,8 @@ if you need extensions not supported in \f[V]gfm\f[R]. .IP \[bu] 2 \f[V]twiki\f[R] (TWiki markup) .IP \[bu] 2 +\f[V]typst\f[R] (typst) +.IP \[bu] 2 \f[V]vimwiki\f[R] (Vimwiki) .IP \[bu] 2 the path of a custom Lua reader, see Custom readers and writers below @@ -499,6 +501,8 @@ at the output of \f[V]pandoc --version\f[R]. Data files placed in this directory (for example, \f[V]reference.odt\f[R], \f[V]reference.docx\f[R], \f[V]epub.css\f[R], \f[V]templates\f[R]) will override pandoc\[cq]s normal defaults. +(Note that the user data directory is not created by pandoc, so you will +need to create it yourself if you want to make use of it.) .TP \f[V]-d\f[R] \f[I]FILE\f[R], \f[V]--defaults=\f[R]\f[I]FILE\f[R] Specify a set of default option settings. @@ -2195,7 +2199,7 @@ The styles may also be mixed in the same template, but the opening and closing delimiter must match in each case. The opening delimiter may be followed by one or more spaces or tabs, which will be ignored. -The closing delimiter may be followed by one or more spaces or tabs, +The closing delimiter may be preceded by one or more spaces or tabs, which will be ignored. .PP To include a literal \f[V]$\f[R] in the document, use \f[V]$$\f[R]. @@ -4431,6 +4435,9 @@ as an ordered list marker in place of a numeral: #. two \f[R] .fi +.PP +Note: the `\f[V]#\f[R]' ordered list marker doesn\[cq]t work with +\f[V]commonmark\f[R]. .SS Extension: \f[V]startnum\f[R] .PP Pandoc also pays attention to the type of list marker used, and to the @@ -4826,7 +4833,7 @@ Cells can span multiple columns or rows: | Temperature +-------+----------+ | 1961-1990 | mean | 14 °C | | +-------+----------+ -| | min | 56.7 °C | +| | max | 56.7 °C | +-------------+-------+----------+ \f[R] .fi @@ -5341,26 +5348,6 @@ If you want to emphasize just part of a word, use \f[V]*\f[R]: feas*ible*, not feas*able*. \f[R] .fi -.SS Highlighting -.PP -To highlight text, use the \f[V]mark\f[R] class: -.IP -.nf -\f[C] -[Mark]{.mark} -\f[R] -.fi -.PP -Or, without the \f[V]bracketed_spans\f[R] extension (but with -\f[V]native_spans\f[R]): -.IP -.nf -\f[C] -<span class=\[dq]mark\[dq]>Mark</span> -\f[R] -.fi -.PP -This will work in html output. .SS Strikeout .SS Extension: \f[V]strikeout\f[R] .PP @@ -5486,6 +5473,26 @@ For compatibility with other Markdown flavors, CSS is also supported: .fi .PP This will work in all output formats that support small caps. +.SS Highlighting +.PP +To highlight text, use the \f[V]mark\f[R] class: +.IP +.nf +\f[C] +[Mark]{.mark} +\f[R] +.fi +.PP +Or, without the \f[V]bracketed_spans\f[R] extension (but with +\f[V]native_spans\f[R]): +.IP +.nf +\f[C] +<span class=\[dq]mark\[dq]>Mark</span> +\f[R] +.fi +.PP +This will work in all output formats that support highlighting. .SS Math .SS Extension: \f[V]tex_math_dollars\f[R] .PP @@ -6054,6 +6061,10 @@ A Div starts with a fence containing at least three consecutive colons plus some attributes. The attributes may optionally be followed by another string of consecutive colons. +.PP +Note: the \f[V]commonmark\f[R] parser doesn\[cq]t permit colons after +the attributes. +.PP The attribute syntax is exactly as in fenced code blocks (see Extension: \f[V]fenced_code_attributes\f[R]). As with fenced code blocks, one can use either attributes in curly @@ -6556,6 +6567,27 @@ or Oxygen is O\[ti]2. \f[R] .fi +.SS Extension: \f[V]wikilinks_title_after_pipe\f[R] +.PP +Pandoc supports multiple markdown wikilink syntaxes, regardless of +whether the title is before or after the pipe. +.PP +Using \f[V]--from=markdown+wikilinks_title_after_pipe\f[R] results in +.IP +.nf +\f[C] +[[URL|title]] +\f[R] +.fi +.PP +while using \f[V]--from=markdown+wikilinks_title_before_pipe\f[R] +results in +.IP +.nf +\f[C] +[[title|URL]] +\f[R] +.fi .SS Markdown variants .PP In addition to pandoc\[cq]s extended Markdown, the following Markdown @@ -6605,7 +6637,7 @@ pandoc --citeproc myinput.txt .PP To use this feature, you will need to have .IP \[bu] 2 -a document containing citations (see Extension: \f[V]citations\f[R]); +a document containing citations (see Citation syntax); .IP \[bu] 2 a source of bibliographic data: either an external bibliography file or a list of \f[V]references\f[R] in the document\[cq]s YAML metadata; |
