From 7dbf03f527ec5e6f55e1c719de89672060a4a671 Mon Sep 17 00:00:00 2001
From: John MacFarlane <jgm@berkeley.edu>
Date: Tue, 14 Jul 2020 13:28:10 -0700
Subject: [PATCH] MANUAL.txt: rewrite Raw HTML/TeX section...
...to avoid duplicate headings for the extensions.
---
MANUAL.txt | 70 +++++++++++++++++++++++-------------------------------
1 file changed, 30 insertions(+), 40 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].
+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