Autype provides several elements to control how content is positioned on pages in the exported document.
Page breaks
Simple page break
A horizontal rule (---) is treated as a page break in the rendered document:
Content on page 1.
---
Content on page 2.
Explicit page break with orientation
Change page orientation with the explicit page break syntax:
---pagebreak{orientation="landscape"}---
---pagebreak{orientation="portrait"}---
Example: Mixed orientations
# Introduction
Regular portrait content here.
---pagebreak{orientation="landscape"}---
## Wide Data Table
| Col 1 | Col 2 | Col 3 | Col 4 | Col 5 | Col 6 | Col 7 | Col 8 |
|-------|-------|-------|-------|-------|-------|-------|-------|
| Data | Data | Data | Data | Data | Data | Data | Data |
---pagebreak{orientation="portrait"}---
## Conclusion
Back to portrait for the conclusion.
Page sections
Page sections let you position content at specific vertical locations on a page. This is essential for title pages, certificates, and custom layouts.
Syntax variant 1: Dash syntax
---page{align=center}---
# Centered Content
This content is vertically centered on the page.
---/page---
Syntax variant 2: Directive syntax
:::page{align=center}
# Centered Content
This content is vertically centered on the page.
:::
Vertical alignment
| Value | Description |
|---|
top | Content starts at the top of the page |
center | Content is vertically centered |
bottom | Content is aligned to the bottom |
Absolute positioning with startY
Position content at an exact vertical position (in points from the top):
---page{align=top startY=100}---
Content starting at 100 points from the top.
---/page---
Attribute reference
| Attribute | Values | Description |
|---|
align | top, center, bottom | Vertical alignment on the page |
startY | Number (points) | Absolute Y position from top of page |
Example: Title page
---page{align=center}---
# Annual Report 2024
## Acme Corporation
*Confidential*
---/page---
---
# Table of Contents
::toc{maxLevel=3}
Example: Certificate
---page{align=center}---
# Certificate of Completion
This certifies that **{{recipientName}}** has successfully completed the course.
**Date:** {{date/D. MMMM YYYY}}
---/page---
Spacers
Add vertical spacing between elements:
Custom height
Lines (default unit):
This adds 2 lines of vertical space.
Pixels:
---spacer{height="50px"}---
Height values
| Format | Description | Example |
|---|
| Number | Lines of space | height=2 → 2 lines |
String with px | Pixels of space | height="50px" → 50 pixels |
| (omitted) | Default: 1 line | ---spacer--- |
Spacers are useful for fine-tuning layout on title pages or between sections where the default paragraph spacing isn’t enough.
