Processing instruction


The "pi" pragma is used to inject an XML processing instruction into the compiled document.


The syntax for the pi pragma consists of:

  • An exclamation point !
  • The keyword pi
  • The XML instructions to be passed through verbatim

This pragma is to be used only when the manuscript is being interpreted as XML, and emitted as an XML document.

!pi xml-instructions
pi pragma syntax

Pragmas can only be used on a line by themselves. They may not be used inside a basic phrase or term phrase. Any leading or trailing whitespace is discarded. Graynotes may be applied by adhering to the standard rules for graynotes.


Here is what a pi pragma looks like within the body of a manuscript.

!option --vocabulary=unchecked            
!option --emit=xml

!pi xml version="1.0" encoding="UTF-8"

xml {
author Anonymous
title One Thousand and One Nights
date unknown
Sample pi pragma

syntax > pragmas > piProcessing instruction

🔗 🔎