aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--MANUAL.txt12
1 files changed, 12 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index 08d3363e9..9e2b98d3d 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -5036,6 +5036,18 @@ hello
::::::
````
+If you include raw HTML or TeX in an output cell, use the
+[raw attribute][Extension: `fenced_attribute`], as shown
+in the last cell of the example above. Although pandoc can
+process "bare" raw HTML and TeX, the result is often
+interspersed raw elements and normal textual elements, and
+in an output cell pandoc expects a single, connected raw
+block. To avoid using raw HTML or TeX except when
+marked explicitly using raw attributes, we recommend
+specifying the extensions `-raw_html-raw_tex+raw_attribute` when
+translating between Markdown and ipynb notebooks.
+
+
Syntax highlighting
===================