update date, man page, README.
This commit is contained in:
John MacFarlane
parent
42b3f558d9
commit
5a216f7bd7
4 changed files with 183 additions and 137 deletions
|
|
@ -1,7 +1,7 @@
|
|||
---
|
||||
title: Pandoc User's Guide
|
||||
author: John MacFarlane
|
||||
date: June 29, 2020
|
||||
date: July 23, 2020
|
||||
---
|
||||
|
||||
# Synopsis
|
||||
|
|
|
|||
2
Makefile
2
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:
|
||||
|
|
|
|||
194
README.md
194
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
|
||||
======
|
||||
|
||||
[](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"),
|
||||
|
|
|
|||
122
man/pandoc.1
122
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
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue