Documentation

Getting started

The migrate, review, edit, generate and consolidate loop — Ristmark's core workflow from an uploaded Word/RTF document to a reusable, data-driven template.

Trust & confidence

How Ristmark earns trust: deterministic editing and generation, AI-assisted layout reconstruction and field identification, and the two fidelity tiers — structured Word/RTF vs. Beta visual reconstruction.

Generating with the /v1 API

The keyed /v1 REST API: create an API key, authenticate, generate a single document or a bounded batch, discover approved templates, export a template, and the error/warning codes to handle.

Pricing & limits

Ristmark's five plans — Free, Basic, Starter, Pro and Scale — their monthly credit allowance, the credit packs, what a credit buys, and what happens at your limit.

Generate from a spreadsheet

Upload a CSV or Excel file, map its columns to a template's fields, and generate one document per row — up to 200 rows per run, downloaded as a zip. The dry-run preview and per-row metering explained.

Aligning and spacing anchored blocks

Line up two or more anchored blocks on a page by their edges or centers, or space three or more out evenly — from the selection bar or with Alt shortcuts.

API keys

Create a key so your own software can generate documents from your approved templates, or build draft templates for your team to review. Keep it safe, rotate it, and revoke it if it leaks.

Approval and versions

What Save, Approve and Publish each do, which copy of a template your documents are generated from, and how to go back to an earlier version.

Authoring API (Beta)

Let your own software or an AI agent build draft templates through an authoring key, how drafts reach your review queue, and the limits that apply.

Build an invoice

A start-to-finish walkthrough of a one-page invoice — letterhead, two address blocks, a line-item table filled from your data, totals worked out for you, and page numbers in the footer.

Document settings

Choose the translation language, the date/number locale, and the currency a document renders with — each shown with a live example before you save.

Fields and bindings

A field is a piece of text pulled from your data instead of typed as fixed wording — what makes one, and the three ways to create one.

Finding the right block

Search by what you are trying to add — "two addresses", "signature", "tick box" — instead of learning the names of the blocks first.

Formatting several blocks at once

Select several blocks and set their font, size, colour or spacing in one go — or copy one block's formatting and paste it onto others.

Grouped line items with subtotals

Build a statement where each group — a category, a project, a department — gets a heading, its own lines and a subtotal, with one grand total at the end.

Headers & footers

A header or footer repeats the same band of content — a logo, an address, a page number — at the top or bottom of every page in a section.

Letterhead and footer

Put your logo and address at the top of every page and a page number at the bottom — either built into a header and footer, or stamped from a PDF of your pre-printed stationery.

Long content and page breaks

Control where a document breaks across pages — keep a heading with its paragraph, keep a group of blocks together, force a new page, and let a long table carry its header onto every page.

Page setup

Every page follows a page setup — size, orientation, margins, and more — configured once per section.

Product cards

Build a catalogue where every product gets its own card — a different photo, name, price and QR code for each record in your data.

Row columns and newspaper columns

Two different things share the word "columns" — a Row puts blocks side by side; newspaper columns make text flow from one column into the next.

Saved recipes

Save blocks you reuse — a signature, an address pair, a legal note — and insert an independent copy into any template in your workspace.

Sections

A section is a page-setup unit — its own size, margins, and header/footer — and a document can have several.

Spacing, size and what is in effect

Which setting makes each gap on the page, which space a control changes, and the width and spacing a block really has — read from the same layout that draws the page.

Teams and people

Who can do what in your workspace — the four roles, how teams keep templates apart, and how to invite, change or remove someone.

Text styles

Name a set of text formatting once — size, typeface, weight, colour, alignment, spacing — and every block you give it to follows when you change it.

The outline

Every section and block in your document in one list, by name — search it, jump to anything, move blocks, and find content a condition is hiding.

Translations

Add the languages a document is written in, translate each key without writing JSON, put data fields inside a text, choose the fallback language, and see which keys a language is missing.

Why is this here?

Shows which page a block is on, what moved, divided or cut it off, and the one change that would put it back — checked before it is offered.

Barcode

A scannable Code 39 stripe barcode for a reference or order number, with the value printed underneath.

Form control

A tick-box or a labelled blank to write in — the fill-in parts of a printed form, drawn as part of the document.

Image

A picture on the page — a logo, a signature, a stamp — sized and placed like any other block.

Label + value

A label and its value kept together as one piece — "Invoice no." beside the number — with an optional rule underneath.

Line

A single drawn rule — the hairline that separates one part of the page from the next.

List

A run of short items, each marked with a bullet or a number — typed in yourself, or built one item per record from your data.

Markdown

The same kind of formatted passage as a Text block, but written with plain-text symbols instead of toolbar buttons.

Page break

Ends the current page early, so whatever follows starts at the top of a fresh page.

Page number

A small automatic line that prints the current page number — the document counts the pages for you, so you never type a number.

QR code

A scannable square code carrying a link or a short piece of text — drawn as sharp vector, so it stays crisp at any size.

Rectangle

A plain filled or outlined box — a coloured band, a highlight panel, or a frame to sit content on.

Repeater

Draws the same small design once for every record in your data — one copy per invoice line, per participant, per row.

Row

Places its contents side by side in columns, instead of stacking them top to bottom.

Ruled form

A ruled form area — draggable lines divide it into regions, and each region holds its own content.

Spacer

An empty gap of a set height — it prints nothing, it just pushes what follows further down.

Stack

Stacks its contents one after another, top to bottom — the vertical counterpart to a row.

Table

A grid of rows and columns — rows you type in yourself, rows filled from your data, or the exact grid a migrated document arrived with.

Text

The everyday block for words on the page — a plain line or paragraph, a passage formatted with bold, headings and lists, or live data.

Export & switching

Export formats, workspace return requests and switching assistance for Ristmark.

Project overview

What Ristmark is and how it's built: deterministic editing and rendering, AI-assisted reconstruction and field recognition, the normalize-recognize-author-generate pipeline, and template consolidation.

Block reference

Every block in the Ristmark template editor in one list — text, layout, tables, pictures, codes and page controls — with a plain description of what each is for and a link to its full guide.

Languages and scripts

What each output — PDF, HTML and Word — does with Arabic, Hebrew, Chinese, Japanese, Korean and other writing systems, measured by rendering real text, and the warning a file carries when one prints wrong.