diff options
| author | John MacFarlane <jgm@berkeley.edu> | 2020-07-23 17:56:12 -0700 | 
|---|---|---|
| committer | John MacFarlane <jgm@berkeley.edu> | 2020-07-23 17:56:12 -0700 | 
| commit | 5a216f7bd75c3f89c6d6217a8676e6fca6229cf7 (patch) | |
| tree | b2dd401253f23709f55b321aebd82e281efdccc2 | |
| parent | 42b3f558d9658d31b7cb94dd2db9624b5081ff63 (diff) | |
| download | pandoc-5a216f7bd75c3f89c6d6217a8676e6fca6229cf7.tar.gz | |
update date, man page, README.
| -rw-r--r-- | MANUAL.txt | 2 | ||||
| -rw-r--r-- | Makefile | 2 | ||||
| -rw-r--r-- | README.md | 194 | ||||
| -rw-r--r-- | man/pandoc.1 | 122 | 
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 @@ -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: @@ -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 +======  [](https://github.com/jgm/pandoc/releases) @@ -19,7 +20,8 @@ tests](https://github.com/jgm/pandoc/workflows/CI%20tests/badge.svg)](https://gi  [](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 | 
