From 24faccdf5daea774d950e6685c38f18c8528b69a Mon Sep 17 00:00:00 2001
From: Tristan Stenner <derstenner@gmail.com>
Date: Mon, 19 Mar 2018 17:20:16 +0100
Subject: [PATCH] Add examples for raw docx blocks (#4472)
The documentation states that the target format name should match the output format, which isn't the case for `docx`/`openxml`.
This PR adds a remark and a frequently requested example (inserting a pagebreak in docx output) to the documentation.
---
MANUAL.txt | 13 ++++++++++++-
1 file changed, 12 insertions(+), 1 deletion(-)
diff --git a/MANUAL.txt b/MANUAL.txt
index ff00288af..e08e9e876 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -3415,9 +3415,20 @@ And the following produces a raw `html` inline element:
This is `<a>html</a>`{=html}
+This can be useful to insert raw xml into `docx` documents, e.g.
+a pagebreak:
+
+ ```{=openxml}
+ <w:p>
+ <w:r>
+ <w:br w:type="page"/>
+ </w:r>
+ </w:p>
+ ```
+
The format name should match the target format name (see
`-t/--to`, above, for a list, or use `pandoc
---list-output-formats`).
+--list-output-formats`). Use `=openxml` for `docx` output.
This extension presupposes that the relevant kind of
inline code or fenced code block is enabled. Thus, for