5a216f7 · typeable/pandoc

git.iko.soy/typeable/pandoc

update date, man page, README.

commit5a216f7bd75c3f89c6d6217a8676e6fca6229cf7 authorJohn MacFarlane <jgm@berkeley.edu> dateThu 23 Jul 2020, 17:56 (6 years ago) parent42b3f55

4 files changed+183−137

compare with master

unifiedsplit

MANUAL.txt+1−1 Makefile+1−1 README.md+102−92 man/pandoc.1+79−43

MANUAL.txt+1−1

@@ -1,7 +1,7 @@

11---

22title: Pandoc User's Guide

33author: John MacFarlane

4−date: June 29, 2020

4+date: July 23, 2020

55---

77# Synopsis

Makefile+1−1

@@ -114,7 +114,7 @@ man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after

114114 -o $@

115115

116116README.md: README.template MANUAL.txt tools/update-readme.lua

117− pandoc --lua-filter tools/update-readme.lua --reference-links \

117+ pandoc --lua-filter tools/update-readme.lua \

118118 --reference-location=section -t gfm $< -o $@

119119

120120download_stats:

README.md+102−92

@@ -3,7 +3,8 @@ README.template and MANUAL.txt via the command:

33pandoc --lua-filter tools/update-readme.lua README.template -o README.md

44-->

6−# Pandoc

6+Pandoc

7+======

89[![github

910release](https://img.shields.io/github/release/jgm/pandoc.svg?label=current+release)](https://github.com/jgm/pandoc/releases)

@@ -19,7 +20,8 @@ tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://gi

1920[![pandoc-discuss on google

2021groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https://groups.google.com/forum/#!forum/pandoc-discuss)

2122

22−## The universal markup converter

23+The universal markup converter

24+------------------------------

2325

2426Pandoc is a [Haskell](http://haskell.org) library for converting from

2527one markup format to another, and a command-line tool that uses this

@@ -27,58 +29,60 @@ library. It can convert *from*

2729

2830<div id="input-formats">

2931

30− - `commonmark` ([CommonMark](https://commonmark.org) Markdown)

31− - `creole` ([Creole 1.0](http://www.wikicreole.org/wiki/Creole1.0))

32− - `csv` ([CSV](https://tools.ietf.org/html/rfc4180) table)

33− - `docbook` ([DocBook](https://docbook.org))

34− - `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))

35− - `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))

36− - `epub` ([EPUB](http://idpf.org/epub))

37− - `fb2`

32+- `commonmark` ([CommonMark](https://commonmark.org) Markdown)

33+- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with

34+ extensions)

35+- `creole` ([Creole 1.0](http://www.wikicreole.org/wiki/Creole1.0))

36+- `csv` ([CSV](https://tools.ietf.org/html/rfc4180) table)

37+- `docbook` ([DocBook](https://docbook.org))

38+- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))

39+- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))

40+- `epub` ([EPUB](http://idpf.org/epub))

41+- `fb2`

3842 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)

3943 e-book)

40− - `gfm` ([GitHub-Flavored

44+- `gfm` ([GitHub-Flavored

4145 Markdown](https://help.github.com/articles/github-flavored-markdown/)),

4246 or the deprecated and less accurate `markdown_github`; use

4347 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)

4448 only if you need extensions not supported in

4549 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).

46− - `haddock` ([Haddock

50+- `haddock` ([Haddock

4751 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))

48− - `html` ([HTML](https://www.w3.org/html/))

49− - `ipynb` ([Jupyter

52+- `html` ([HTML](https://www.w3.org/html/))

53+- `ipynb` ([Jupyter

5054 notebook](https://nbformat.readthedocs.io/en/latest/))

51− - `jats` ([JATS](https://jats.nlm.nih.gov) XML)

52− - `jira`

55+- `jats` ([JATS](https://jats.nlm.nih.gov) XML)

56+- `jira`

5357 ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence

5458 wiki markup)

55− - `json` (JSON version of native AST)

56− - `latex` ([LaTeX](https://www.latex-project.org/))

57− - `markdown` ([Pandoc’s

59+- `json` (JSON version of native AST)

60+- `latex` ([LaTeX](https://www.latex-project.org/))

61+- `markdown` ([Pandoc’s

5862 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))

59− - `markdown_mmd`

63+- `markdown_mmd`

6064 ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))

61− - `markdown_phpextra` ([PHP Markdown

65+- `markdown_phpextra` ([PHP Markdown

6266 Extra](https://michelf.ca/projects/php-markdown/extra/))

63− - `markdown_strict` (original unextended

67+- `markdown_strict` (original unextended

6468 [Markdown](https://daringfireball.net/projects/markdown/))

65− - `mediawiki` ([MediaWiki

69+- `mediawiki` ([MediaWiki

6670 markup](https://www.mediawiki.org/wiki/Help:Formatting))

67− - `man` ([roff man](https://man.cx/groff_man$7$))

68− - `muse` ([Muse](https://amusewiki.org/library/manual))

69− - `native` (native Haskell)

70− - `odt` ([ODT](https://en.wikipedia.org/wiki/OpenDocument))

71− - `opml` ([OPML](http://dev.opml.org/spec2.html))

72− - `org` ([Emacs Org mode](https://orgmode.org))

73− - `rst`

71+- `man` ([roff man](https://man.cx/groff_man(7)))

72+- `muse` ([Muse](https://amusewiki.org/library/manual))

73+- `native` (native Haskell)

74+- `odt` ([ODT](https://en.wikipedia.org/wiki/OpenDocument))

75+- `opml` ([OPML](http://dev.opml.org/spec2.html))

76+- `org` ([Emacs Org mode](https://orgmode.org))

77+- `rst`

7478 ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))

75− - `t2t` ([txt2tags](https://txt2tags.org))

76− - `textile` ([Textile](https://www.promptworks.com/textile))

77− - `tikiwiki` ([TikiWiki

79+- `t2t` ([txt2tags](https://txt2tags.org))

80+- `textile` ([Textile](https://www.promptworks.com/textile))

81+- `tikiwiki` ([TikiWiki

7882 markup](https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax))

79− - `twiki` ([TWiki

83+- `twiki` ([TWiki

8084 markup](https://twiki.org/cgi-bin/view/TWiki/TextFormattingRules))

81− - `vimwiki` ([Vimwiki](https://vimwiki.github.io))

85+- `vimwiki` ([Vimwiki](https://vimwiki.github.io))

8286

8387</div>

8488

@@ -86,94 +90,96 @@ It can convert *to*

8690

8791<div id="output-formats">

8892

89− - `asciidoc` ([AsciiDoc](https://www.methods.co.nz/asciidoc/)) or

93+- `asciidoc` ([AsciiDoc](https://www.methods.co.nz/asciidoc/)) or

9094 `asciidoctor` ([AsciiDoctor](https://asciidoctor.org/))

91− - `beamer` ([LaTeX beamer](https://ctan.org/pkg/beamer) slide show)

92− - `commonmark` ([CommonMark](https://commonmark.org) Markdown)

93− - `context` ([ConTeXt](https://www.contextgarden.net/))

94− - `docbook` or `docbook4` ([DocBook](https://docbook.org) 4)

95− - `docbook5` (DocBook 5)

96− - `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))

97− - `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))

98− - `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)

99− - `epub2` (EPUB v2)

100− - `fb2`

95+- `beamer` ([LaTeX beamer](https://ctan.org/pkg/beamer) slide show)

96+- `commonmark` ([CommonMark](https://commonmark.org) Markdown)

97+- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with

98+ extensions)

99+- `context` ([ConTeXt](https://www.contextgarden.net/))

100+- `docbook` or `docbook4` ([DocBook](https://docbook.org) 4)

101+- `docbook5` (DocBook 5)

102+- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))

103+- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))

104+- `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)

105+- `epub2` (EPUB v2)

106+- `fb2`

101107 ([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)

102108 e-book)

103− - `gfm` ([GitHub-Flavored

109+- `gfm` ([GitHub-Flavored

104110 Markdown](https://help.github.com/articles/github-flavored-markdown/)),

105111 or the deprecated and less accurate `markdown_github`; use

106112 [`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)

107113 only if you need extensions not supported in

108114 [`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).

109− - `haddock` ([Haddock

115+- `haddock` ([Haddock

110116 markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))

111− - `html` or `html5` ([HTML](https://www.w3.org/html/),

117+- `html` or `html5` ([HTML](https://www.w3.org/html/),

112118 i.e. [HTML5](https://html.spec.whatwg.org/)/XHTML [polyglot

113119 markup](https://www.w3.org/TR/html-polyglot/))

114− - `html4` ([XHTML](https://www.w3.org/TR/xhtml1/) 1.0 Transitional)

115− - `icml` ([InDesign

120+- `html4` ([XHTML](https://www.w3.org/TR/xhtml1/) 1.0 Transitional)

121+- `icml` ([InDesign

116122 ICML](https://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf))

117− - `ipynb` ([Jupyter

123+- `ipynb` ([Jupyter

118124 notebook](https://nbformat.readthedocs.io/en/latest/))

119− - `jats_archiving` ([JATS](https://jats.nlm.nih.gov) XML, Archiving

125+- `jats_archiving` ([JATS](https://jats.nlm.nih.gov) XML, Archiving

120126 and Interchange Tag Set)

121− - `jats_articleauthoring` ([JATS](https://jats.nlm.nih.gov) XML,

127+- `jats_articleauthoring` ([JATS](https://jats.nlm.nih.gov) XML,

122128 Article Authoring Tag Set)

123− - `jats_publishing` ([JATS](https://jats.nlm.nih.gov) XML, Journal

129+- `jats_publishing` ([JATS](https://jats.nlm.nih.gov) XML, Journal

124130 Publishing Tag Set)

125− - `jats` (alias for `jats_archiving`)

126− - `jira`

131+- `jats` (alias for `jats_archiving`)

132+- `jira`

127133 ([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence

128134 wiki markup)

129− - `json` (JSON version of native AST)

130− - `latex` ([LaTeX](https://www.latex-project.org/))

131− - `man` ([roff man](https://man.cx/groff_man$7$))

132− - `markdown` ([Pandoc’s

135+- `json` (JSON version of native AST)

136+- `latex` ([LaTeX](https://www.latex-project.org/))

137+- `man` ([roff man](https://man.cx/groff_man(7)))

138+- `markdown` ([Pandoc’s

133139 Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))

134− - `markdown_mmd`

140+- `markdown_mmd`

135141 ([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))

136− - `markdown_phpextra` ([PHP Markdown

142+- `markdown_phpextra` ([PHP Markdown

137143 Extra](https://michelf.ca/projects/php-markdown/extra/))

138− - `markdown_strict` (original unextended

144+- `markdown_strict` (original unextended

139145 [Markdown](https://daringfireball.net/projects/markdown/))

140− - `mediawiki` ([MediaWiki

146+- `mediawiki` ([MediaWiki

141147 markup](https://www.mediawiki.org/wiki/Help:Formatting))

142− - `ms` ([roff ms](https://man.cx/groff_ms$7$))

143− - `muse` ([Muse](https://amusewiki.org/library/manual)),

144− - `native` (native Haskell),

145− - `odt` ([OpenOffice text

148+- `ms` ([roff ms](https://man.cx/groff_ms(7)))

149+- `muse` ([Muse](https://amusewiki.org/library/manual)),

150+- `native` (native Haskell),

151+- `odt` ([OpenOffice text

146152 document](https://en.wikipedia.org/wiki/OpenDocument))

147− - `opml` ([OPML](http://dev.opml.org/spec2.html))

148− - `opendocument` ([OpenDocument](http://opendocument.xml.org))

149− - `org` ([Emacs Org mode](https://orgmode.org))

150− - `pdf` ([PDF](https://www.adobe.com/pdf/))

151− - `plain` (plain text),

152− - `pptx`

153+- `opml` ([OPML](http://dev.opml.org/spec2.html))

154+- `opendocument` ([OpenDocument](http://opendocument.xml.org))

155+- `org` ([Emacs Org mode](https://orgmode.org))

156+- `pdf` ([PDF](https://www.adobe.com/pdf/))

157+- `plain` (plain text),

158+- `pptx`

153159 ([PowerPoint](https://en.wikipedia.org/wiki/Microsoft_PowerPoint)

154160 slide show)

155− - `rst`

161+- `rst`

156162 ([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))

157− - `rtf` ([Rich Text

163+- `rtf` ([Rich Text

158164 Format](https://en.wikipedia.org/wiki/Rich_Text_Format))

159− - `texinfo` ([GNU Texinfo](https://www.gnu.org/software/texinfo/))

160− - `textile` ([Textile](https://www.promptworks.com/textile))

161− - `slideous` ([Slideous](https://goessner.net/articles/slideous/) HTML

165+- `texinfo` ([GNU Texinfo](https://www.gnu.org/software/texinfo/))

166+- `textile` ([Textile](https://www.promptworks.com/textile))

167+- `slideous` ([Slideous](https://goessner.net/articles/slideous/) HTML

162168 and JavaScript slide show)

163− - `slidy` ([Slidy](https://www.w3.org/Talks/Tools/Slidy2/) HTML and

169+- `slidy` ([Slidy](https://www.w3.org/Talks/Tools/Slidy2/) HTML and

164170 JavaScript slide show)

165− - `dzslides` ([DZSlides](http://paulrouget.com/dzslides/) HTML5 +

171+- `dzslides` ([DZSlides](http://paulrouget.com/dzslides/) HTML5 +

166172 JavaScript slide show),

167− - `revealjs` ([reveal.js](https://revealjs.com/) HTML5 + JavaScript

173+- `revealjs` ([reveal.js](https://revealjs.com/) HTML5 + JavaScript

168174 slide show)

169− - `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript

175+- `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript

170176 slide show)

171− - `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))

172− - `xwiki` ([XWiki

177+- `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))

178+- `xwiki` ([XWiki

173179 markup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/))

174− - `zimwiki` ([ZimWiki

180+- `zimwiki` ([ZimWiki

175181 markup](https://zim-wiki.org/manual/Help/Wiki_Syntax.html))

176− - the path of a custom Lua writer, see [Custom

182+- the path of a custom Lua writer, see [Custom

177183 writers](https://pandoc.org/MANUAL.html#custom-writers) below

178184

179185</div>

@@ -204,11 +210,13 @@ While conversions from pandoc’s Markdown to all formats aspire to be

204210perfect, conversions from formats more expressive than pandoc’s Markdown

205211can be expected to be lossy.

206212

207−## Installing

213+Installing

214+----------

208215

209216Here’s [how to install pandoc](INSTALL.md).

210217

211−## Documentation

218+Documentation

219+-------------

212220

213221Pandoc’s website contains a full [User’s

214222Guide](https://pandoc.org/MANUAL.html). It is also available

@@ -217,13 +225,15 @@ contains some [examples of the use of

217225pandoc](https://pandoc.org/demos.html) and a limited [online

218226demo](https://pandoc.org/try).

219227

220−## Contributing

228+Contributing

229+------------

221230

222231Pull requests, bug reports, and feature requests are welcome. Please

223232make sure to read [the contributor guidelines](CONTRIBUTING.md) before

224233opening a new issue.

225234

226−## License

235+License

236+-------

227237

229239[GPL](http://www.gnu.org/copyleft/gpl.html "GNU General Public License"),

man/pandoc.1+79−43

@@ -1,7 +1,7 @@

11.\"t

2−.\" Automatically generated by Pandoc 2.10

2+.\" Automatically generated by Pandoc 2.10.1

33.\"

4−.TH "Pandoc User\[aq]s Guide" "" "June 29, 2020" "pandoc 2.10" ""

4+.TH "Pandoc User\[aq]s Guide" "" "July 23, 2020" "pandoc 2.10.1" ""

55.hy

66.SH NAME

77pandoc - general markup converter

@@ -229,6 +229,8 @@ Specify input format.

229229.IP \[bu] 2

230230\f[C]commonmark\f[R] (CommonMark Markdown)

231231.IP \[bu] 2

232+\f[C]commonmark_x\f[R] (CommonMark Markdown with extensions)

233+.IP \[bu] 2

232234\f[C]creole\f[R] (Creole 1.0)

233235.IP \[bu] 2

234236\f[C]csv\f[R] (CSV table)

@@ -313,6 +315,8 @@ Specify output format.

313315.IP \[bu] 2

314316\f[C]commonmark\f[R] (CommonMark Markdown)

315317.IP \[bu] 2

318+\f[C]commonmark_x\f[R] (CommonMark Markdown with extensions)

319+.IP \[bu] 2

316320\f[C]context\f[R] (ConTeXt)

317321.IP \[bu] 2

318322\f[C]docbook\f[R] or \f[C]docbook4\f[R] (DocBook 4)

@@ -936,7 +940,7 @@ line, or when resources used in a document must be downloaded).

936940If you\[aq]re behind a proxy, you also need to set the environment

937941variable \f[C]http_proxy\f[R] to \f[C]http://...\f[R].

938942.TP

939−\[ga]--no-check-certificate

943+\f[B]\f[CB]--no-check-certificate\f[B]\f[R]

940944Disable the certificate verification to allow access to unsecure HTTP

941945resources (for example when the certificate is no longer valid or self

942946signed).

@@ -1017,7 +1021,7 @@ become \f[C]\[rs]part{..}\f[R], while second-level headings remain as

10171021their default type.

10181022.TP

10191023\f[B]\f[CB]-N\f[B]\f[R], \f[B]\f[CB]--number-sections\f[B]\f[R]

1020−Number section headings in LaTeX, ConTeXt, HTML, or EPUB output.

1024+Number section headings in LaTeX, ConTeXt, HTML, Docx, or EPUB output.

10211025By default, sections are not numbered.

10221026Sections with class \f[C]unnumbered\f[R] will never be numbered, even if

10231027\f[C]--number-sections\f[R] is specified.

@@ -1196,6 +1200,8 @@ Verbatim Char

11961200Footnote Reference

11971201.IP \[bu] 2

11981202Hyperlink

1203+.IP \[bu] 2

1204+Section Number

11991205.PP

12001206Table style:

12011207.IP \[bu] 2

@@ -3131,20 +3137,18 @@ This is handy for reading web pages formatted using MathJax, for

31313137example.

31323138.SS Raw HTML/TeX

31333139.PP

3134−The following extensions (especially how they affect Markdown

3135−input/output) are also described in more detail in their respective

3136−sections of Pandoc\[aq]s Markdown.

3137−.SS Extension: \f[C]raw_html\f[R]

3138−.PP

3139−When converting from HTML, parse elements to raw HTML which are not

3140−representable in pandoc\[aq]s AST.

3140+The following extensions are described in more detail in their

3141+respective sections of Pandoc\[aq]s Markdown:

3142+.IP \[bu] 2

3143+\f[C]raw_html\f[R] allows HTML elements which are not representable in

3144+pandoc\[aq]s AST to be parsed as raw HTML.

31413145By default, this is disabled for HTML input.

3142−.SS Extension: \f[C]raw_tex\f[R]

3143−.PP

3144−Allows raw LaTeX, TeX, and ConTeXt to be included in a document.

3145−.PP

3146+.IP \[bu] 2

3147+\f[C]raw_tex\f[R] allows raw LaTeX, TeX, and ConTeXt to be included in a

3148+document.

31463149This extension can be enabled/disabled for the following formats (in

31473150addition to \f[C]markdown\f[R]):

3151+.RS 2

31483152.TP

31493153input formats

31503154\f[C]latex\f[R], \f[C]org\f[R], \f[C]textile\f[R], \f[C]html\f[R]

@@ -3162,24 +3166,20 @@ possible outputs when several options are given, you will get best

31623166results if you disable \f[C]raw_html\f[R] and \f[C]raw_tex\f[R] when

31633167converting to formats like \f[C]docx\f[R] which don\[aq]t allow raw

31643168\f[C]html\f[R] or \f[C]tex\f[R].

3165−.SS Extension: \f[C]native_divs\f[R]

3166−.PP

3167−This extension is enabled by default for HTML input.

3168−This means that \f[C]div\f[R]s are parsed to pandoc native elements.

3169−(Alternatively, you can parse them to raw HTML using

3170−\f[C]-f html-native_divs+raw_html\f[R].)

3171−.PP

3172−When converting HTML to Markdown, for example, you may want to drop all

3173−\f[C]div\f[R]s and \f[C]span\f[R]s:

3174−.IP

3175−.nf

3176−\f[C]

3177−pandoc -f html-native_divs-native_spans -t markdown

3178−\f[R]

3179−.fi

3180−.SS Extension: \f[C]native_spans\f[R]

3181−.PP

3182−Analogous to \f[C]native_divs\f[R] above.

3169+.RE

3170+.IP \[bu] 2

3171+\f[C]native_divs\f[R] causes HTML \f[C]div\f[R] elements to be parsed as

3172+native pandoc Div blocks.

3173+If you want them to be parsed as raw HTML, use

3174+\f[C]-f html-native_divs+raw_html\f[R].

3175+.IP \[bu] 2

3176+\f[C]native_spans\f[R] causes HTML \f[C]span\f[R] elements to be parsed

3177+as native pandoc Span inlines.

3178+If you want them to be parsed as raw HTML, use

3179+\f[C]-f html-native_spans+raw_html\f[R].

3180+If you want to drop all \f[C]div\f[R]s and \f[C]span\f[R]s when

3181+converting HTML to Markdown, you can use

3182+\f[C]pandoc -f html-native_divs-native_spans -t markdown\f[R].

31833183.SS Literate Haskell support

31843184.SS Extension: \f[C]literate_haskell\f[R]

31853185.PP

@@ -3289,6 +3289,13 @@ input formats

32893289.PP

32903290In the \f[C]muse\f[R] input format, this enables Text::Amuse extensions

32913291to Emacs Muse markup.

3292+.SS Extension: \f[C]raw_markdown\f[R]

3293+.PP

3294+In the \f[C]ipynb\f[R] input format, this causes Markdown cells to be

3295+included as raw Markdown blocks (allowing lossless round-tripping)

3296+rather than being parsed.

3297+Use this only when you are targetting \f[C]ipynb\f[R] or a

3298+markdown-based output format.

32923299.SS Extension: \f[C]citations\f[R]

32933300.PP

32943301Some aspects of Pandoc\[aq]s Markdown citation syntax are also accepted

@@ -5909,6 +5916,39 @@ pandoc, but may be enabled by adding \f[C]+EXTENSION\f[R] to the format

59095916name, where \f[C]EXTENSION\f[R] is the name of the extension.

59105917Thus, for example, \f[C]markdown+hard_line_breaks\f[R] is Markdown with

59115918hard line breaks.

5919+.SS Extension: \f[C]attributes\f[R]

5920+.PP

5921+Allows attributes to be attached to any inline or block-level element.

5922+The syntax for the attributes is the same as that used in

5923+\f[C]header_attributes\f[R].

5924+.IP \[bu] 2

5925+Attributes that occur immediately after an inline element affect that

5926+element.

5927+If they follow a space, then they belong to the space.

5928+(Hence, this option subsumes \f[C]inline_code_attributes\f[R] and

5929+\f[C]link_attributes\f[R].)

5930+.IP \[bu] 2

5931+Attributes that occur immediately before a block element, on a line by

5932+themselves, affect that element.

5933+.IP \[bu] 2

5934+Consecutive attribute specifiers may be used, either for blocks or for

5935+inlines.

5936+Their attributes will be combined.

5937+.IP \[bu] 2

5938+Attributes that occur at the end of the text of a Setext or ATX heading

5939+(separated by whitespace from the text) affect the heading element.

5940+(Hence, this option subsumes \f[C]header_attributes\f[R].)

5941+.IP \[bu] 2

5942+Attributes that occur after the opening fence in a fenced code block

5943+affect the code block element.

5944+(Hence, this option subsumes \f[C]fenced_code_attributes\f[R].)

5945+.IP \[bu] 2

5946+Attributes that occur at the end of a reference link definition affect

5947+links that refer to that definition.

5948+.PP

5949+Note that pandoc\[aq]s AST does not currently allow attributes to be

5950+attached to arbitrary elements.

5951+Hence a Span or Div container will be added if needed.

59125952.SS Extension: \f[C]old_dashes\f[R]

59135953.PP

59145954Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:

@@ -6105,11 +6145,12 @@ The extensions can, however, all be individually disabled.

61056145Also, \f[C]raw_tex\f[R] only affects \f[C]gfm\f[R] output, not input.

61066146.TP

61076147\f[B]\f[CB]gfm\f[B]\f[R] (GitHub-Flavored Markdown)

6108−\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]fenced_code_blocks\f[R],

6109−\f[C]auto_identifiers\f[R], \f[C]gfm_auto_identifiers\f[R],

6110−\f[C]backtick_code_blocks\f[R], \f[C]autolink_bare_uris\f[R],

6111−\f[C]space_in_atx_header\f[R], \f[C]intraword_underscores\f[R],

6112−\f[C]strikeout\f[R], \f[C]task_lists\f[R], \f[C]emoji\f[R],

6148+\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]native_divs\f[R],

6149+\f[C]fenced_code_blocks\f[R], \f[C]auto_identifiers\f[R],

6150+\f[C]gfm_auto_identifiers\f[R], \f[C]backtick_code_blocks\f[R],

6151+\f[C]autolink_bare_uris\f[R], \f[C]space_in_atx_header\f[R],

6152+\f[C]intraword_underscores\f[R], \f[C]strikeout\f[R],

6153+\f[C]task_lists\f[R], \f[C]emoji\f[R],

61136154\f[C]shortcut_reference_links\f[R], \f[C]angle_brackets_escapable\f[R],

61146155\f[C]lists_without_preceding_blankline\f[R].

61156156.SH PRODUCING SLIDE SHOWS WITH PANDOC

@@ -6782,11 +6823,6 @@ T}@T{

67826823frontmatter

67836824T}

67846825T{

6785−titlepage

6786−T}@T{

6787−frontmatter

6788−T}

6789−T{

67906826appendix

67916827T}@T{

67926828backmatter