diff options
| -rw-r--r-- | MANUAL.txt | 84 |
1 files changed, 37 insertions, 47 deletions
diff --git a/MANUAL.txt b/MANUAL.txt index 7d7906f20..b0e21ca75 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -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]. - -#### Extension: `raw_html` {#raw_html} - -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. - -#### Extension: `raw_tex` {#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`): - -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. - +The following extensions are described in more detail in +their respective sections of [Pandoc's Markdown]: + +- [`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. + +- [`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`): + + 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`. + +- [`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 |