Skip to main content

 Element reference

PSML elements from <author> to <xref>



The <para> element represents a paragraph.

Paragraphs can be numbered automatically using the @numbered attribute or manually using the @prefix attribute.

Usage context

Element categoryblock
PSML levelportable
Permitted contentcharacter-style elements, text and images
Permitted parent<fragment> <item> <block> <cell>
HTML equivalent<p> 
OpenXML equivalent<w:p>


This element includes the following attributes:

indentindentnoNumber of levels to indent (1 to 6)
numberedbooleannoIf this paragraph is numbered
prefixxs:stringnoPrefix for paragraph (used for numbered paragraphs)


The number of levels to indent the paragraph. The indent applies to the whole paragraph but not to subsequent paragraphs.

In the portable PSML level, the indent must not exceed 6, however, in processed PSML, it is possible that the computed paragraph indent exceeds 6.


A boolean flag to indicate whether the attributes are numbered automatically.

In the user interface, if the auto-number can not be calculated it appears as a series of ‘y.’ which signals that the publication configuration might need to be modified.


A manual prefix for the paragraph.

A manual prefix is an alternative to the auto-numbered prefix and overrides the auto-number.

Although there is no limit on the size of a prefix, be aware that it might not be practical to display long prefixes.



A paragraph.

<para>A simple paragraph.</para>

The previous PSML is converted to HTML as:

<p>A simple paragraph.</p>

 Auto-numbered paragraph

An indented auto-numbered paragraph.

<para numbered="true" indent="2">This paragraph is indented.</para>

By default numbered paragraphs are indented.

Prefixed paragraph

An indented paragraph using the manual prefix “2(b)”

<para indent="2" prefix="2(b)">Another paragraph</para>


XML Schema

<xs:element name="para">
  <xs:complexType mixed="true">
    <xs:choice minOccurs="0" maxOccurs="unbounded">
      <xs:group ref="character-style-group" />
      <xs:element ref="image" />
    <xs:attribute name="indent">
        <xs:restriction base="xs:integer">
          <xs:pattern value="[1-6]"/>
    <xs:attribute name="prefix" type="xs:string" />
    <xs:attribute name="numbered"
                  default="false" />

Relax Schema

element para {
  attribute indent { xs:integer }?,
  attribute prefix { xs:string }?,
  attribute numbered { xs: boolean }?,
  (character-style-group | image)+


This element was introduced in the first draft of PSML and is well-supported from PageSeeder 5.1.

Created on , last edited on