aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn MacFarlane <jgm@berkeley.edu>2020-07-23 17:56:12 -0700
committerJohn MacFarlane <jgm@berkeley.edu>2020-07-23 17:56:12 -0700
commit5a216f7bd75c3f89c6d6217a8676e6fca6229cf7 (patch)
treeb2dd401253f23709f55b321aebd82e281efdccc2
parent42b3f558d9658d31b7cb94dd2db9624b5081ff63 (diff)
downloadpandoc-5a216f7bd75c3f89c6d6217a8676e6fca6229cf7.tar.gz
update date, man page, README.
-rw-r--r--MANUAL.txt2
-rw-r--r--Makefile2
-rw-r--r--README.md194
-rw-r--r--man/pandoc.1122
4 files changed, 183 insertions, 137 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index aab56c9d7..762fdad59 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -1,7 +1,7 @@
---
title: Pandoc User's Guide
author: John MacFarlane
-date: June 29, 2020
+date: July 23, 2020
---
# Synopsis
diff --git a/Makefile b/Makefile
index f0752b742..d07d24026 100644
--- a/Makefile
+++ b/Makefile
@@ -114,7 +114,7 @@ man/pandoc.1: MANUAL.txt man/pandoc.1.before man/pandoc.1.after
-o $@
README.md: README.template MANUAL.txt tools/update-readme.lua
- pandoc --lua-filter tools/update-readme.lua --reference-links \
+ pandoc --lua-filter tools/update-readme.lua \
--reference-location=section -t gfm $< -o $@
download_stats:
diff --git a/README.md b/README.md
index 2c76e0bb5..28e3e4bc0 100644
--- a/README.md
+++ b/README.md
@@ -3,7 +3,8 @@ README.template and MANUAL.txt via the command:
pandoc --lua-filter tools/update-readme.lua README.template -o README.md
-->
-# Pandoc
+Pandoc
+======
[![github
release](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
[![pandoc-discuss on google
groups](https://img.shields.io/badge/pandoc-discuss-red.svg?style=social)](https://groups.google.com/forum/#!forum/pandoc-discuss)
-## The universal markup converter
+The universal markup converter
+------------------------------
Pandoc is a [Haskell](http://haskell.org) library for converting from
one markup format to another, and a command-line tool that uses this
@@ -27,58 +29,60 @@ library. It can convert *from*
<div id="input-formats">
- - `commonmark` ([CommonMark](https://commonmark.org) Markdown)
- - `creole` ([Creole 1.0](http://www.wikicreole.org/wiki/Creole1.0))
- - `csv` ([CSV](https://tools.ietf.org/html/rfc4180) table)
- - `docbook` ([DocBook](https://docbook.org))
- - `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
- - `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
- - `epub` ([EPUB](http://idpf.org/epub))
- - `fb2`
+- `commonmark` ([CommonMark](https://commonmark.org) Markdown)
+- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with
+ extensions)
+- `creole` ([Creole 1.0](http://www.wikicreole.org/wiki/Creole1.0))
+- `csv` ([CSV](https://tools.ietf.org/html/rfc4180) table)
+- `docbook` ([DocBook](https://docbook.org))
+- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
+- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
+- `epub` ([EPUB](http://idpf.org/epub))
+- `fb2`
([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
e-book)
- - `gfm` ([GitHub-Flavored
+- `gfm` ([GitHub-Flavored
Markdown](https://help.github.com/articles/github-flavored-markdown/)),
or the deprecated and less accurate `markdown_github`; use
[`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
only if you need extensions not supported in
[`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
- - `haddock` ([Haddock
+- `haddock` ([Haddock
markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
- - `html` ([HTML](https://www.w3.org/html/))
- - `ipynb` ([Jupyter
+- `html` ([HTML](https://www.w3.org/html/))
+- `ipynb` ([Jupyter
notebook](https://nbformat.readthedocs.io/en/latest/))
- - `jats` ([JATS](https://jats.nlm.nih.gov) XML)
- - `jira`
+- `jats` ([JATS](https://jats.nlm.nih.gov) XML)
+- `jira`
([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence
wiki markup)
- - `json` (JSON version of native AST)
- - `latex` ([LaTeX](https://www.latex-project.org/))
- - `markdown` ([Pandoc’s
+- `json` (JSON version of native AST)
+- `latex` ([LaTeX](https://www.latex-project.org/))
+- `markdown` ([Pandoc’s
Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
- - `markdown_mmd`
+- `markdown_mmd`
([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
- - `markdown_phpextra` ([PHP Markdown
+- `markdown_phpextra` ([PHP Markdown
Extra](https://michelf.ca/projects/php-markdown/extra/))
- - `markdown_strict` (original unextended
+- `markdown_strict` (original unextended
[Markdown](https://daringfireball.net/projects/markdown/))
- - `mediawiki` ([MediaWiki
+- `mediawiki` ([MediaWiki
markup](https://www.mediawiki.org/wiki/Help:Formatting))
- - `man` ([roff man](https://man.cx/groff_man\(7\)))
- - `muse` ([Muse](https://amusewiki.org/library/manual))
- - `native` (native Haskell)
- - `odt` ([ODT](https://en.wikipedia.org/wiki/OpenDocument))
- - `opml` ([OPML](http://dev.opml.org/spec2.html))
- - `org` ([Emacs Org mode](https://orgmode.org))
- - `rst`
+- `man` ([roff man](https://man.cx/groff_man(7)))
+- `muse` ([Muse](https://amusewiki.org/library/manual))
+- `native` (native Haskell)
+- `odt` ([ODT](https://en.wikipedia.org/wiki/OpenDocument))
+- `opml` ([OPML](http://dev.opml.org/spec2.html))
+- `org` ([Emacs Org mode](https://orgmode.org))
+- `rst`
([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
- - `t2t` ([txt2tags](https://txt2tags.org))
- - `textile` ([Textile](https://www.promptworks.com/textile))
- - `tikiwiki` ([TikiWiki
+- `t2t` ([txt2tags](https://txt2tags.org))
+- `textile` ([Textile](https://www.promptworks.com/textile))
+- `tikiwiki` ([TikiWiki
markup](https://doc.tiki.org/Wiki-Syntax-Text#The_Markup_Language_Wiki-Syntax))
- - `twiki` ([TWiki
+- `twiki` ([TWiki
markup](https://twiki.org/cgi-bin/view/TWiki/TextFormattingRules))
- - `vimwiki` ([Vimwiki](https://vimwiki.github.io))
+- `vimwiki` ([Vimwiki](https://vimwiki.github.io))
</div>
@@ -86,94 +90,96 @@ It can convert *to*
<div id="output-formats">
- - `asciidoc` ([AsciiDoc](https://www.methods.co.nz/asciidoc/)) or
+- `asciidoc` ([AsciiDoc](https://www.methods.co.nz/asciidoc/)) or
`asciidoctor` ([AsciiDoctor](https://asciidoctor.org/))
- - `beamer` ([LaTeX beamer](https://ctan.org/pkg/beamer) slide show)
- - `commonmark` ([CommonMark](https://commonmark.org) Markdown)
- - `context` ([ConTeXt](https://www.contextgarden.net/))
- - `docbook` or `docbook4` ([DocBook](https://docbook.org) 4)
- - `docbook5` (DocBook 5)
- - `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
- - `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
- - `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)
- - `epub2` (EPUB v2)
- - `fb2`
+- `beamer` ([LaTeX beamer](https://ctan.org/pkg/beamer) slide show)
+- `commonmark` ([CommonMark](https://commonmark.org) Markdown)
+- `commonmark_x` ([CommonMark](https://commonmark.org) Markdown with
+ extensions)
+- `context` ([ConTeXt](https://www.contextgarden.net/))
+- `docbook` or `docbook4` ([DocBook](https://docbook.org) 4)
+- `docbook5` (DocBook 5)
+- `docx` ([Word docx](https://en.wikipedia.org/wiki/Office_Open_XML))
+- `dokuwiki` ([DokuWiki markup](https://www.dokuwiki.org/dokuwiki))
+- `epub` or `epub3` ([EPUB](http://idpf.org/epub) v3 book)
+- `epub2` (EPUB v2)
+- `fb2`
([FictionBook2](http://www.fictionbook.org/index.php/Eng:XML_Schema_Fictionbook_2.1)
e-book)
- - `gfm` ([GitHub-Flavored
+- `gfm` ([GitHub-Flavored
Markdown](https://help.github.com/articles/github-flavored-markdown/)),
or the deprecated and less accurate `markdown_github`; use
[`markdown_github`](https://pandoc.org/MANUAL.html#markdown-variants)
only if you need extensions not supported in
[`gfm`](https://pandoc.org/MANUAL.html#markdown-variants).
- - `haddock` ([Haddock
+- `haddock` ([Haddock
markup](https://www.haskell.org/haddock/doc/html/ch03s08.html))
- - `html` or `html5` ([HTML](https://www.w3.org/html/),
+- `html` or `html5` ([HTML](https://www.w3.org/html/),
i.e. [HTML5](https://html.spec.whatwg.org/)/XHTML [polyglot
markup](https://www.w3.org/TR/html-polyglot/))
- - `html4` ([XHTML](https://www.w3.org/TR/xhtml1/) 1.0 Transitional)
- - `icml` ([InDesign
+- `html4` ([XHTML](https://www.w3.org/TR/xhtml1/) 1.0 Transitional)
+- `icml` ([InDesign
ICML](https://wwwimages.adobe.com/www.adobe.com/content/dam/acom/en/devnet/indesign/sdk/cs6/idml/idml-cookbook.pdf))
- - `ipynb` ([Jupyter
+- `ipynb` ([Jupyter
notebook](https://nbformat.readthedocs.io/en/latest/))
- - `jats_archiving` ([JATS](https://jats.nlm.nih.gov) XML, Archiving
+- `jats_archiving` ([JATS](https://jats.nlm.nih.gov) XML, Archiving
and Interchange Tag Set)
- - `jats_articleauthoring` ([JATS](https://jats.nlm.nih.gov) XML,
+- `jats_articleauthoring` ([JATS](https://jats.nlm.nih.gov) XML,
Article Authoring Tag Set)
- - `jats_publishing` ([JATS](https://jats.nlm.nih.gov) XML, Journal
+- `jats_publishing` ([JATS](https://jats.nlm.nih.gov) XML, Journal
Publishing Tag Set)
- - `jats` (alias for `jats_archiving`)
- - `jira`
+- `jats` (alias for `jats_archiving`)
+- `jira`
([Jira](https://jira.atlassian.com/secure/WikiRendererHelpAction.jspa?section=all)/Confluence
wiki markup)
- - `json` (JSON version of native AST)
- - `latex` ([LaTeX](https://www.latex-project.org/))
- - `man` ([roff man](https://man.cx/groff_man\(7\)))
- - `markdown` ([Pandoc’s
+- `json` (JSON version of native AST)
+- `latex` ([LaTeX](https://www.latex-project.org/))
+- `man` ([roff man](https://man.cx/groff_man(7)))
+- `markdown` ([Pandoc’s
Markdown](https://pandoc.org/MANUAL.html#pandocs-markdown))
- - `markdown_mmd`
+- `markdown_mmd`
([MultiMarkdown](https://fletcherpenney.net/multimarkdown/))
- - `markdown_phpextra` ([PHP Markdown
+- `markdown_phpextra` ([PHP Markdown
Extra](https://michelf.ca/projects/php-markdown/extra/))
- - `markdown_strict` (original unextended
+- `markdown_strict` (original unextended
[Markdown](https://daringfireball.net/projects/markdown/))
- - `mediawiki` ([MediaWiki
+- `mediawiki` ([MediaWiki
markup](https://www.mediawiki.org/wiki/Help:Formatting))
- - `ms` ([roff ms](https://man.cx/groff_ms\(7\)))
- - `muse` ([Muse](https://amusewiki.org/library/manual)),
- - `native` (native Haskell),
- - `odt` ([OpenOffice text
+- `ms` ([roff ms](https://man.cx/groff_ms(7)))
+- `muse` ([Muse](https://amusewiki.org/library/manual)),
+- `native` (native Haskell),
+- `odt` ([OpenOffice text
document](https://en.wikipedia.org/wiki/OpenDocument))
- - `opml` ([OPML](http://dev.opml.org/spec2.html))
- - `opendocument` ([OpenDocument](http://opendocument.xml.org))
- - `org` ([Emacs Org mode](https://orgmode.org))
- - `pdf` ([PDF](https://www.adobe.com/pdf/))
- - `plain` (plain text),
- - `pptx`
+- `opml` ([OPML](http://dev.opml.org/spec2.html))
+- `opendocument` ([OpenDocument](http://opendocument.xml.org))
+- `org` ([Emacs Org mode](https://orgmode.org))
+- `pdf` ([PDF](https://www.adobe.com/pdf/))
+- `plain` (plain text),
+- `pptx`
([PowerPoint](https://en.wikipedia.org/wiki/Microsoft_PowerPoint)
slide show)
- - `rst`
+- `rst`
([reStructuredText](https://docutils.sourceforge.io/docs/ref/rst/introduction.html))
- - `rtf` ([Rich Text
+- `rtf` ([Rich Text
Format](https://en.wikipedia.org/wiki/Rich_Text_Format))
- - `texinfo` ([GNU Texinfo](https://www.gnu.org/software/texinfo/))
- - `textile` ([Textile](https://www.promptworks.com/textile))
- - `slideous` ([Slideous](https://goessner.net/articles/slideous/) HTML
+- `texinfo` ([GNU Texinfo](https://www.gnu.org/software/texinfo/))
+- `textile` ([Textile](https://www.promptworks.com/textile))
+- `slideous` ([Slideous](https://goessner.net/articles/slideous/) HTML
and JavaScript slide show)
- - `slidy` ([Slidy](https://www.w3.org/Talks/Tools/Slidy2/) HTML and
+- `slidy` ([Slidy](https://www.w3.org/Talks/Tools/Slidy2/) HTML and
JavaScript slide show)
- - `dzslides` ([DZSlides](http://paulrouget.com/dzslides/) HTML5 +
+- `dzslides` ([DZSlides](http://paulrouget.com/dzslides/) HTML5 +
JavaScript slide show),
- - `revealjs` ([reveal.js](https://revealjs.com/) HTML5 + JavaScript
+- `revealjs` ([reveal.js](https://revealjs.com/) HTML5 + JavaScript
slide show)
- - `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript
+- `s5` ([S5](https://meyerweb.com/eric/tools/s5/) HTML and JavaScript
slide show)
- - `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))
- - `xwiki` ([XWiki
+- `tei` ([TEI Simple](https://github.com/TEIC/TEI-Simple))
+- `xwiki` ([XWiki
markup](https://www.xwiki.org/xwiki/bin/view/Documentation/UserGuide/Features/XWikiSyntax/))
- - `zimwiki` ([ZimWiki
+- `zimwiki` ([ZimWiki
markup](https://zim-wiki.org/manual/Help/Wiki_Syntax.html))
- - the path of a custom Lua writer, see [Custom
+- the path of a custom Lua writer, see [Custom
writers](https://pandoc.org/MANUAL.html#custom-writers) below
</div>
@@ -204,11 +210,13 @@ While conversions from pandoc’s Markdown to all formats aspire to be
perfect, conversions from formats more expressive than pandoc’s Markdown
can be expected to be lossy.
-## Installing
+Installing
+----------
Here’s [how to install pandoc](INSTALL.md).
-## Documentation
+Documentation
+-------------
Pandoc’s website contains a full [User’s
Guide](https://pandoc.org/MANUAL.html). It is also available
@@ -217,13 +225,15 @@ contains some [examples of the use of
pandoc](https://pandoc.org/demos.html) and a limited [online
demo](https://pandoc.org/try).
-## Contributing
+Contributing
+------------
Pull requests, bug reports, and feature requests are welcome. Please
make sure to read [the contributor guidelines](CONTRIBUTING.md) before
opening a new issue.
-## License
+License
+-------
© 2006-2020 John MacFarlane (jgm@berkeley.edu). Released under the
[GPL](http://www.gnu.org/copyleft/gpl.html "GNU General Public License"),
diff --git a/man/pandoc.1 b/man/pandoc.1
index fb88a6745..50335cc3c 100644
--- a/man/pandoc.1
+++ b/man/pandoc.1
@@ -1,7 +1,7 @@
.\"t
-.\" Automatically generated by Pandoc 2.10
+.\" Automatically generated by Pandoc 2.10.1
.\"
-.TH "Pandoc User\[aq]s Guide" "" "June 29, 2020" "pandoc 2.10" ""
+.TH "Pandoc User\[aq]s Guide" "" "July 23, 2020" "pandoc 2.10.1" ""
.hy
.SH NAME
pandoc - general markup converter
@@ -229,6 +229,8 @@ Specify input format.
.IP \[bu] 2
\f[C]commonmark\f[R] (CommonMark Markdown)
.IP \[bu] 2
+\f[C]commonmark_x\f[R] (CommonMark Markdown with extensions)
+.IP \[bu] 2
\f[C]creole\f[R] (Creole 1.0)
.IP \[bu] 2
\f[C]csv\f[R] (CSV table)
@@ -313,6 +315,8 @@ Specify output format.
.IP \[bu] 2
\f[C]commonmark\f[R] (CommonMark Markdown)
.IP \[bu] 2
+\f[C]commonmark_x\f[R] (CommonMark Markdown with extensions)
+.IP \[bu] 2
\f[C]context\f[R] (ConTeXt)
.IP \[bu] 2
\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).
If you\[aq]re behind a proxy, you also need to set the environment
variable \f[C]http_proxy\f[R] to \f[C]http://...\f[R].
.TP
-\[ga]--no-check-certificate
+\f[B]\f[CB]--no-check-certificate\f[B]\f[R]
Disable the certificate verification to allow access to unsecure HTTP
resources (for example when the certificate is no longer valid or self
signed).
@@ -1017,7 +1021,7 @@ become \f[C]\[rs]part{..}\f[R], while second-level headings remain as
their default type.
.TP
\f[B]\f[CB]-N\f[B]\f[R], \f[B]\f[CB]--number-sections\f[B]\f[R]
-Number section headings in LaTeX, ConTeXt, HTML, or EPUB output.
+Number section headings in LaTeX, ConTeXt, HTML, Docx, or EPUB output.
By default, sections are not numbered.
Sections with class \f[C]unnumbered\f[R] will never be numbered, even if
\f[C]--number-sections\f[R] is specified.
@@ -1196,6 +1200,8 @@ Verbatim Char
Footnote Reference
.IP \[bu] 2
Hyperlink
+.IP \[bu] 2
+Section Number
.PP
Table style:
.IP \[bu] 2
@@ -3131,20 +3137,18 @@ This is handy for reading web pages formatted using MathJax, for
example.
.SS Raw HTML/TeX
.PP
-The following extensions (especially how they affect Markdown
-input/output) are also described in more detail in their respective
-sections of Pandoc\[aq]s Markdown.
-.SS Extension: \f[C]raw_html\f[R]
-.PP
-When converting from HTML, parse elements to raw HTML which are not
-representable in pandoc\[aq]s AST.
+The following extensions are described in more detail in their
+respective sections of Pandoc\[aq]s Markdown:
+.IP \[bu] 2
+\f[C]raw_html\f[R] allows HTML elements which are not representable in
+pandoc\[aq]s AST to be parsed as raw HTML.
By default, this is disabled for HTML input.
-.SS Extension: \f[C]raw_tex\f[R]
-.PP
-Allows raw LaTeX, TeX, and ConTeXt to be included in a document.
-.PP
+.IP \[bu] 2
+\f[C]raw_tex\f[R] allows raw LaTeX, TeX, and ConTeXt to be included in a
+document.
This extension can be enabled/disabled for the following formats (in
addition to \f[C]markdown\f[R]):
+.RS 2
.TP
input formats
\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
results if you disable \f[C]raw_html\f[R] and \f[C]raw_tex\f[R] when
converting to formats like \f[C]docx\f[R] which don\[aq]t allow raw
\f[C]html\f[R] or \f[C]tex\f[R].
-.SS Extension: \f[C]native_divs\f[R]
-.PP
-This extension is enabled by default for HTML input.
-This means that \f[C]div\f[R]s are parsed to pandoc native elements.
-(Alternatively, you can parse them to raw HTML using
-\f[C]-f html-native_divs+raw_html\f[R].)
-.PP
-When converting HTML to Markdown, for example, you may want to drop all
-\f[C]div\f[R]s and \f[C]span\f[R]s:
-.IP
-.nf
-\f[C]
-pandoc -f html-native_divs-native_spans -t markdown
-\f[R]
-.fi
-.SS Extension: \f[C]native_spans\f[R]
-.PP
-Analogous to \f[C]native_divs\f[R] above.
+.RE
+.IP \[bu] 2
+\f[C]native_divs\f[R] causes HTML \f[C]div\f[R] elements to be parsed as
+native pandoc Div blocks.
+If you want them to be parsed as raw HTML, use
+\f[C]-f html-native_divs+raw_html\f[R].
+.IP \[bu] 2
+\f[C]native_spans\f[R] causes HTML \f[C]span\f[R] elements to be parsed
+as native pandoc Span inlines.
+If you want them to be parsed as raw HTML, use
+\f[C]-f html-native_spans+raw_html\f[R].
+If you want to drop all \f[C]div\f[R]s and \f[C]span\f[R]s when
+converting HTML to Markdown, you can use
+\f[C]pandoc -f html-native_divs-native_spans -t markdown\f[R].
.SS Literate Haskell support
.SS Extension: \f[C]literate_haskell\f[R]
.PP
@@ -3289,6 +3289,13 @@ input formats
.PP
In the \f[C]muse\f[R] input format, this enables Text::Amuse extensions
to Emacs Muse markup.
+.SS Extension: \f[C]raw_markdown\f[R]
+.PP
+In the \f[C]ipynb\f[R] input format, this causes Markdown cells to be
+included as raw Markdown blocks (allowing lossless round-tripping)
+rather than being parsed.
+Use this only when you are targetting \f[C]ipynb\f[R] or a
+markdown-based output format.
.SS Extension: \f[C]citations\f[R]
.PP
Some 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
name, where \f[C]EXTENSION\f[R] is the name of the extension.
Thus, for example, \f[C]markdown+hard_line_breaks\f[R] is Markdown with
hard line breaks.
+.SS Extension: \f[C]attributes\f[R]
+.PP
+Allows attributes to be attached to any inline or block-level element.
+The syntax for the attributes is the same as that used in
+\f[C]header_attributes\f[R].
+.IP \[bu] 2
+Attributes that occur immediately after an inline element affect that
+element.
+If they follow a space, then they belong to the space.
+(Hence, this option subsumes \f[C]inline_code_attributes\f[R] and
+\f[C]link_attributes\f[R].)
+.IP \[bu] 2
+Attributes that occur immediately before a block element, on a line by
+themselves, affect that element.
+.IP \[bu] 2
+Consecutive attribute specifiers may be used, either for blocks or for
+inlines.
+Their attributes will be combined.
+.IP \[bu] 2
+Attributes that occur at the end of the text of a Setext or ATX heading
+(separated by whitespace from the text) affect the heading element.
+(Hence, this option subsumes \f[C]header_attributes\f[R].)
+.IP \[bu] 2
+Attributes that occur after the opening fence in a fenced code block
+affect the code block element.
+(Hence, this option subsumes \f[C]fenced_code_attributes\f[R].)
+.IP \[bu] 2
+Attributes that occur at the end of a reference link definition affect
+links that refer to that definition.
+.PP
+Note that pandoc\[aq]s AST does not currently allow attributes to be
+attached to arbitrary elements.
+Hence a Span or Div container will be added if needed.
.SS Extension: \f[C]old_dashes\f[R]
.PP
Selects the pandoc <= 1.8.2.1 behavior for parsing smart dashes:
@@ -6105,11 +6145,12 @@ The extensions can, however, all be individually disabled.
Also, \f[C]raw_tex\f[R] only affects \f[C]gfm\f[R] output, not input.
.TP
\f[B]\f[CB]gfm\f[B]\f[R] (GitHub-Flavored Markdown)
-\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]fenced_code_blocks\f[R],
-\f[C]auto_identifiers\f[R], \f[C]gfm_auto_identifiers\f[R],
-\f[C]backtick_code_blocks\f[R], \f[C]autolink_bare_uris\f[R],
-\f[C]space_in_atx_header\f[R], \f[C]intraword_underscores\f[R],
-\f[C]strikeout\f[R], \f[C]task_lists\f[R], \f[C]emoji\f[R],
+\f[C]pipe_tables\f[R], \f[C]raw_html\f[R], \f[C]native_divs\f[R],
+\f[C]fenced_code_blocks\f[R], \f[C]auto_identifiers\f[R],
+\f[C]gfm_auto_identifiers\f[R], \f[C]backtick_code_blocks\f[R],
+\f[C]autolink_bare_uris\f[R], \f[C]space_in_atx_header\f[R],
+\f[C]intraword_underscores\f[R], \f[C]strikeout\f[R],
+\f[C]task_lists\f[R], \f[C]emoji\f[R],
\f[C]shortcut_reference_links\f[R], \f[C]angle_brackets_escapable\f[R],
\f[C]lists_without_preceding_blankline\f[R].
.SH PRODUCING SLIDE SHOWS WITH PANDOC
@@ -6782,11 +6823,6 @@ T}@T{
frontmatter
T}
T{
-titlepage
-T}@T{
-frontmatter
-T}
-T{
appendix
T}@T{
backmatter