Text

The <Text> element renders styled text content. Text nodes support font selection, sizing, color, alignment, and underline.

Example

<Text font_size="14" font_name="OpenSans" style="bold"
      alignment="center" color="#333333">
  Welcome to Docraft
</Text>

Attributes

Attribute	Type	Description
`font_size`	float	Font size in points (default `12`).
`font_name`	string	Font family name (default `Helvetica`, one of the built-in PDF fonts, or a family registered via `<Fonts>` — see Default Font for setting this once for the whole document instead of on every node).
`style`	string	`normal` \| `bold` \| `italic` \| `bold_italic`.
`alignment`	string	`left` \| `center` \| `right` \| `justified`. Resolved inside the box given by `width`; without an explicit `width` the box is whatever the parent container relays, which inside a `<Canvas>` is the whole canvas.
`width`	float	The text’s own box, in points: text is word-wrapped to it and `alignment` is resolved inside it. Omitted, the text is drawn as a single unwrapped line and inherits the parent’s width for alignment.
`color`	color	Text color (hex or named — see Color Values).
`underline`	bool	Enable underline rendering.
`strikeout`	bool	Enable strikeout rendering. Independent of `underline` — both can be enabled at once.

The text content is the inner text of the XML element.

Word-wrapping is driven by width: given one, the text is wrapped to that box at measure time, and each resulting line is aligned within it. Without one, the text is laid out as a single line — it is not wrapped to the container’s natural width.

<!-- centred on its own 120pt box, not on the parent -->
<Text width="120" alignment="center">Label</Text>

Title & Subtitle

<Title> and <Subtitle> are <Text> variants with larger, bold defaults and extra margin that tracks the effective font_size — useful for headings without repeating styling on every <Text>. Every <Text> attribute above still applies and overrides the defaults.

<Title>Quarterly Report</Title>
<Subtitle font_size="16">Q1 2026</Subtitle>

PageNumber

<PageNumber> is a special text node whose content is automatically replaced by the current page number at render time. It supports the same attributes as <Text>.

<Footer>
  <PageNumber font_size="10" alignment="center"/>
</Footer>

Paragraph

<Paragraph> groups several <Text> runs into one flowing block — see Layout for how it composes with <Layout> containers.

<Paragraph line_spacing="1.5" space_before="4" space_after="6" alignment="center">
  <Text>First run.</Text>
  <Text>Second run, same paragraph.</Text>
</Paragraph>

Attribute	Type	Description
`line_spacing`	float	Line-height multiplier (default `1.2`).
`space_before`	float	Space above the paragraph in points (default `0`).
`space_after`	float	Space below the paragraph in points (default `0`).
`alignment`	string	Default alignment for children; each `<Text>` can still override it.