From 4810f300e1bfcca24b5abac007bbd836b16934db Mon Sep 17 00:00:00 2001
From: John MacFarlane <jgm@berkeley.edu>
Date: Sat, 9 Mar 2019 16:53:26 -0800
Subject: [PATCH] Add recommendation to use `raw_attribute` with ipynb.

See #5354.
---
 MANUAL.txt | 12 ++++++++++++
 1 file changed, 12 insertions(+)

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
 ===================