Marking up mark-up languages

The syntax phrase (synph) element can be used to describe elements and attributes in a mark-up language.

When documenting XML mark-up languages, you should use the syntax phrase (synph) element to identify the names of language elements and attributes.

Do not use angular brackets to identify names of elements, or prefix attribute names with "@". These formatting conventions should be added, if required, during the publishing process.

You should consider specialising synph into two separate elements, one to identify elements and one to identify attributes, to better semantically differentiate the two.

If you are including code snippets rather than describing the name of an element or attribute, use the code phrase (codeph) or code block (codeblock) element, and not the synph element.