git.iko.soy/typeable/pandoc
on master help sign in
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.

commit24faccdf5daea774d950e6685c38f18c8528b69a authorTristan Stenner <derstenner@gmail.com> dateMon 19 Mar 2018, 17:20 (9 years ago) parentd6f9715
1 file changed+12−1
MANUAL.txt+12−1
MANUAL.txt+12−1
@@ -3415,9 +3415,20 @@ And the following produces a raw `html` inline element:
34153415
34163416 This is `<a>html</a>`{=html}
34173417
3418+This can be useful to insert raw xml into `docx` documents, e.g.
3419+a pagebreak:
3420+
3421+ ```{=openxml}
3422+ <w:p>
3423+ <w:r>
3424+ <w:br w:type="page"/>
3425+ </w:r>
3426+ </w:p>
3427+ ```
3428+
34183429The format name should match the target format name (see
34193430`-t/--to`, above, for a list, or use `pandoc
3420−--list-output-formats`).
3431+--list-output-formats`). Use `=openxml` for `docx` output.
34213432
34223433This extension presupposes that the relevant kind of
34233434inline code or fenced code block is enabled. Thus, for