Layout Keywords

Six keywords for controlling how a document looks when rendered — pagination, headers, footers, watermarks, document-wide style rules, and print page breaks.

page:

Category: Layout Aliases: صفحة:

Defines the page layout settings for print and PDF output.

Syntax

page: | size: value | orientation: value | margin: value

Properties

Property	Type	Description
size	string	Paper size — A4, letter, legal, A3
orientation	string	portrait (default) or landscape
margin	string	CSS margin value — 1in, 2cm, normal, narrow

Examples

page: | size: A4 | orientation: portrait | margin: 1in
page: | size: letter | orientation: landscape | margin: 2cm

Notes

• Browser rendering inherits the system default — page: primarily affects PDF export and print
• Only one page: block per document is valid
• margin: normal is equivalent to 1in top/bottom, 1.25in left/right (Word defaults)
• margin: narrow is equivalent to 0.5in on all sides

---

header:

Category: Layout Aliases: ترويسة:

Defines the running header for multi-page output.

Syntax

header: content | align: value | show-on: value

Properties

Property	Type	Description
align	string	left (default), center, or right
show-on	string	all (default), odd, even, after-first

Examples

header: Acme Corporation Confidential
header: | align: right | show-on: all
header: Service Agreement v1.0 | align: center | show-on: after-first

Notes

• Header is hidden in web rendering — visible in print and PDF only
• show-on: after-first is standard for formal documents — suppresses the header on the title page
• Content can include template variables: {{title}}, {{page}}, {{date}}

---

footer:

Category: Layout Aliases: تذييل:

Defines the running footer for multi-page output, including page numbers.

Syntax

footer: content | align: value | show-on: value

Properties

Property	Type	Description
align	string	left, center (default), or right
show-on	string	all (default), odd, even, after-first

Examples

footer: Page {{page}} of {{pages}}
footer: Confidential — Acme Corporation | align: center | show-on: all
footer: {{date}} | align: right | show-on: after-first

Template variables

Variable	Output
{{page}}	Current page number
{{pages}}	Total page count
{{title}}	Document title
{{date}}	Current date (render time)
{{author}}	Author from meta: block

Notes

• Footer is hidden in web rendering — visible in print and PDF only
• show-on: after-first is standard practice — suppresses footer on the title/cover page

---

watermark:

Category: Layout Aliases: علامة:

Watermark printed diagonally across every page.

Syntax

watermark: text | opacity: value | color: value | angle: degrees

Properties

Property	Type	Description
opacity	number	0.0–1.0, default 0.15
color	string	CSS color — default gray
angle	number	Rotation in degrees, default 45

Examples

watermark: DRAFT
watermark: CONFIDENTIAL | opacity: 0.2 | color: red
watermark: For Review Only | opacity: 0.1 | angle: 30

In a template, make the watermark a variable — pass empty data to skip it, or different values per version:

watermark: {{watermark_text}} | color: {{watermark_color}}

Notes

• Printed diagonally across every page in print/PDF output
• Visible in web rendering as a CSS background layer
• Opacity guide: 0.03–0.05 very subtle, 0.06–0.10 standard, 0.10–0.15 strong, above that it obscures content
• Remove by deleting the watermark: block — sealing the document with freeze: prevents removal

---

break:

Category: Layout Aliases: فاصل:

Page break for print output. Invisible in web rendering — renders as display:none with aria-hidden="true". In print and PDF, forces a page break at the point where break: appears.

Syntax

break:
break: | before: value | keep: value

Properties

Property	Type	Description
before	boolean	Force a page break before the following content
keep	string	Keep surrounding content together — together or avoid

Examples

section: Chapter One
text: Introduction material...

break:

section: Chapter Two
text: New chapter starts on a fresh page.

break: | before: true | keep: together

break: vs x-layout: divider

	break:	x-layout: divider
Visible in	Print/PDF only	Both web and print
Effect	Forces page boundary	Visual horizontal rule
Print	New page	<hr> on the page
Web	Invisible (display:none)	Rendered thematic break

Use break: for structural pagination. Use x-layout: divider for visible section dividers.

---

style:

Category: Layout Aliases: نمط:

Scoped document style rule — house styling for a block type, declared once, document-wide. Keeps presentation out of the content body: lines stay clean and queryable while the document carries its own look (e.g. per-tenant branding in a stored template).

Syntax

style: target | key: value | key: value

Properties

The target (the content before the first |) is a block type: title, summary, section, sub, text, quote, callout, info, table, table-header, metric, contact, divider. Unknown targets are ignored.

The values are the standard style properties — color, size, family, weight, bg, align, indent, opacity, italic, border, underline, strike — never arbitrary CSS.

Examples

style: section | color: #0a7 | weight: 600
style: title | family: Georgia | size: 26pt
style: metric | color: #333

Notes

• Rules apply after the theme (house style wins); per-line props and inline [text]{…} spans still override a rule (most-specific wins).
• style: lines never render as body content and round-trip byte-exact.
• The web editor shows each rule as a 🎨 chip and applies it live to the canvas — identical to print output.

---

Extension keywords

Typography and decorative layout keywords are available in the x-layout: and x-doc: namespaces. These are rendered by the renderer but do not affect the core document model.

Extension	Purpose
x-layout: font	Typography settings — family, size, line-height
x-layout: divider	Visual horizontal rule, shown in both web and print
x-doc: signline	Physical signature line for printed/PDF contracts

See the extensions overview in Keywords → for full syntax.