Tissevert/pandoc
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

MANUAL.txt: rewrite Raw HTML/TeX section...

Browse source 
...to avoid duplicate headings for the extensions.
This commit is contained in:
John MacFarlane 2020-07-14 13:28:10 -07:00
parent 8ede05161f
commit 7dbf03f527
1 changed files with 30 additions and 40 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

70
MANUAL.txt
View file

@ -2767,53 +2767,43 @@ reading web pages formatted using MathJax, for example.
## Raw HTML/TeX
The following extensions (especially how they affect Markdown
input/output) are also described in more detail in their respective
sections of [Pandoc's Markdown].
The following extensions are described in more detail in
their respective sections of [Pandoc's Markdown]:
#### Extension: `raw_html` {#raw_html}
- [`raw_html`](#extension-raw_html) allows HTML elements which
are not representable in pandoc's AST to be parsed as raw HTML.
By default, this is disabled for HTML input.
When converting from HTML, parse elements to raw HTML which are not
representable in pandoc's AST.
By default, this is disabled for HTML input.
- [`raw_tex`](#extension-raw_tex) 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 `markdown`):
#### Extension: `raw_tex` {#raw_tex}
input formats
: `latex`, `org`, `textile`, `html` (environments, `\ref`, and
`\eqref` only), `ipynb`
Allows raw LaTeX, TeX, and ConTeXt to be included in a document.
output formats
: `textile`, `commonmark`
This extension can be enabled/disabled for the following formats
(in addition to `markdown`):
Note: as applied to `ipynb`, `raw_html` and `raw_tex` affect not
only raw TeX in markdown cells, but data with mime type
`text/html` in output cells. Since the `ipynb` reader attempts
to preserve the richest possible outputs when several options
are given, you will get best results if you disable `raw_html`
and `raw_tex` when converting to formats like `docx` which don't
allow raw `html` or `tex`.
input formats
: `latex`, `org`, `textile`, `html` (environments, `\ref`, and
`\eqref` only), `ipynb`
output formats
: `textile`, `commonmark`
Note: as applied to `ipynb`, `raw_html` and `raw_tex` affect not
only raw TeX in markdown cells, but data with mime type
`text/html` in output cells. Since the `ipynb` reader attempts
to preserve the richest possible outputs when several options
are given, you will get best results if you disable `raw_html`
and `raw_tex` when converting to formats like `docx` which don't
allow raw `html` or `tex`.
#### Extension: `native_divs` {#native_divs}
This extension is enabled by default for HTML input. This means that
`div`s are parsed to pandoc native elements. (Alternatively, you
can parse them to raw HTML using `-f html-native_divs+raw_html`.)
When converting HTML to Markdown, for example, you may want to drop all
`div`s and `span`s:
pandoc -f html-native_divs-native_spans -t markdown
#### Extension: `native_spans` {#native_spans}
Analogous to `native_divs` above.
- [`native_divs`](#extension-native_divs) causes HTML `div`
elements to be parsed as native pandoc Div blocks.
If you want them to be parsed as raw HTML, use
`-f html-native_divs+raw_html`.
- [`native_spans`](#extension-native_spans) causes HTML `span`
elements to be parsed as native pandoc Span inlines.
If you want them to be parsed as raw HTML, use
`-f html-native_spans+raw_html`. If you want to drop all
`div`s and `span`s when converting HTML to Markdown, you
can use `pandoc -f html-native_divs-native_spans -t markdown`.
## Literate Haskell support