Word- und PowerPoint-Vorlagen

Eine Office-Vorlage ist ein Word-Dokument (Art docx) oder eine PowerPoint-Präsentation (Art pptx), die Sie selbst in Word oder PowerPoint schreiben. Tags in Jinja2, Liquid oder Handlebars tippen Sie wie jeden anderen Text in das Dokument, und ein Rendering füllt sie mit Daten. Das Ergebnis behält alles, was die Datei schon hat: Formatvorlagen, Kopf- und Fußzeilen, Seiteneinrichtung, Tabellen, Bilder und Foliendesign.

Angebot {{ offer.number }} für {{ customer.name }}

Ein Rendering erzeugt das ausgefüllte Dokument (docx oder pptx) oder ein PDF davon. Nehmen Sie eine Office-Vorlage, wenn das Dokument in Word oder PowerPoint von Leuten gepflegt wird, die kein HTML schreiben, oder wenn der Empfänger eine bearbeitbare Datei braucht. Für Dokumente, die in HTML und CSS gestaltet sind, nehmen Sie eine PDF-Vorlage.

Eine Office-Vorlage anlegen

In der App

1. Wählen Sie auf der Seite Vorlagen die Schaltfläche Neue Vorlage.
2. Stellen Sie Art auf Word-Dokument oder PowerPoint-Präsentation und wählen Sie die Engine, deren Tag-Syntax Sie tippen möchten.
3. Wählen Sie Mit dem Formfeed-Beispiel beginnen (ein Angebot mit Beispiel-Tags) für eine Datei mit Beispiel-Tags und passenden Beispieldaten, oder Eigene Datei hochladen und Datei auswählen….
4. Vorlage anlegen.

Die Vorlage öffnet sich auf einer eigenen Seite (siehe unten). Um das Dokument zu ändern, laden Sie es herunter, bearbeiten es in Word oder PowerPoint und laden es mit Datei ersetzen… wieder hoch.

Mit der API

Senden Sie die Datei als multipart/form-data an POST /v1/templates:

curl https://api-eu.formfeed.dev/v1/templates \
  -H "Authorization: Bearer $FORMFEED_API_KEY" \
  -F name="Angebot" -F slug=offer -F kind=docx -F engine=jinja2 \
  -F 'sample_data={"customer": {"name": "Olvarest GmbH"}}' \
  -F publish=true \
  -F file=@angebot.docx

file ist das Dokument. Die übrigen Felder sind Formularfelder: settings, sample_data, data_sets, data_schema, i18n und tags als JSON-Text, publish als true oder false. Der Schlüssel braucht den Scope template:write. Neue Versionen, Downloads und die Aufrufe der SDKs beschreibt die Vorlagen-API.

Als Code

Ein Vorlagenordner enthält template.docx oder template.pptx statt template.html, und template.json nennt die Art. formfeed templates push lädt das Dokument hoch, wenn es sich geändert hat. Siehe Projektstruktur und Vorlagen als Code weiter unten.

Eine Vorlagendatei darf bis zu 20 MB groß sein (darüber 413 file_too_large). Ihr Typ wird aus dem Inhalt gelesen, nie aus dem Namen: Eine Word-Vorlage nimmt eine .docx-Datei, eine PowerPoint-Vorlage eine .pptx-Datei. Alles andere beantwortet die API mit 415 file_type_unsupported: Dateien mit Makros (.docm, .pptm), Word- und PowerPoint-Dokumentvorlagen und Bildschirmpräsentationen (.dotx, .potx, .ppsx), die alten Binärformate (.doc, .ppt) und eine Datei der jeweils anderen Art. Öffnen Sie eine solche Datei in Word oder PowerPoint und speichern Sie sie zuerst als .docx oder .pptx. Eine passwortgeschützte Datei beantwortet die API mit 422 source_encrypted; entfernen Sie das Passwort vor dem Hochladen.

Tags

Tippen Sie Tags als normalen Text in das Dokument, in der Syntax der Engine der Vorlage. Alles, was die Vorlagensprachen für Text bieten, funktioniert: Variablen, Filter, if, for, set, Kommentare.

Jinja2

Sehr geehrte/r {{ customer.contact }},
Summe: {{ offer.total | money }}, gültig bis {{ offer.valid_until | date("dd.MM.yyyy") }}
{% if offer.discount %}inklusive {{ offer.discount }} % Rabatt{% endif %}

Liquid

Sehr geehrte/r {{ customer.contact }},
Summe: {{ offer.total | money }}, gültig bis {{ offer.valid_until | date: "dd.MM.yyyy" }}
{% if offer.discount %}inklusive {{ offer.discount }} % Rabatt{% endif %}

Handlebars

Sehr geehrte/r {{customer.contact}},
Summe: {{money offer.total}}, gültig bis {{date offer.valid_until "dd.MM.yyyy"}}
{{#if offer.discount}}inklusive {{offer.discount}} % Rabatt{{/if}}

• Die Formatierung folgt dem Tag. Der Wert übernimmt die Formatierung des ersten Zeichens des Tags. Setzen Sie {{ customer.name }} in Word fett, erscheint der Name fett. Text außerhalb von Tags bleibt unverändert.
• Word kann ein Tag zerteilen. Rechtschreibprüfung, eine Korrektur oder ein Formatwechsel mitten im Tag lassen Word es in mehreren Stücken speichern. Formfeed fügt sie wieder zusammen, solange das Tag in einem Absatz bleibt.
• AutoKorrektur in Tags wird rückgängig gemacht. Word macht beim Tippen aus " typografische Anführungszeichen, was date("dd.MM.yyyy") zerstören würde. Innerhalb von {{ }}, {% %} und {# #} macht Formfeed aus typografischen Anführungszeichen wieder gerade, aus Halbgeviert- und Geviertstrichen -, aus … wieder ..., aus geschützten Leerzeichen normale und entfernt Zeichen ohne Breite. Das Panel Tags vermerkt jede Änderung (office-tag-autocorrected). Text außerhalb von Tags behält die Typografie von Word.
• Werte sind Text. Was ein Tag ausgibt, wird als Text eingefügt, auch HTML; Daten können die Struktur des Dokuments also nicht verändern. Zeilenumbrüche und Tabulatoren in den Daten werden zu Zeilenumbrüchen und Tabulatoren im Dokument; Zeichen, die Dokumente nicht enthalten dürfen, werden entfernt.
• <, > und & funktionieren wie getippt: {% if total > 1000 %}.

Schleifen und Bedingungen über Absätze und Zeilen

Ein Block-Tag ({% for %}, {% if %}, {% else %}, {% endfor %}, {% tablerow %} aus Liquid, {{#each}}, {{else}}, {{/if}} und so weiter), das allein in seinem Absatz steht, steht für den ganzen Absatz. Der Absatz verschwindet aus dem Ergebnis: Eine Schleife wiederholt die Absätze zwischen ihren Tags, eine Bedingung blendet sie ein oder aus. Auch ein {% set %} oder ein Kommentar allein in seinem Absatz verschwindet mit dem Absatz und hinterlässt keine Leerzeile.

{% for line in offer.lines %}
• {{ line.description }}: {{ line.total | money }}
{% endfor %}

Steht dieser Absatz außerdem allein in seiner Tabellenzeile, sind also alle anderen Zellen der Zeile leer, steht das Tag für die ganze Zeile. Eine Tabelle mit einer Zeile, die {% for line in offer.lines %} enthält, einer Datenzeile und einer Zeile mit {% endfor %} wiederholt die Datenzeile einmal je Position, und die beiden Tag-Zeilen verschwinden:

Beschreibung	Menge	Summe
{% for line in offer.lines %}
{{ line.description }}	{{ line.qty }}	{{ line.total | money }}
{% endfor %}

Die Regel lautet: allein im Absatz, allein in der Zeile. Ein Block-Tag im Fließtext bleibt inline und wirkt nur auf diesen Text: {% if paid %}BEZAHLT{% endif %}.

• Öffnendes und schließendes Tag eines Blocks müssen am selben Ort stehen: beide im Haupttext oder beide in derselben Tabellenzelle, Kopfzeile, Fußzeile oder Textbox. Sonst meldet die Vorlage office-block-unbalanced.
• Die Struktur, die Word und PowerPoint brauchen, bleibt erhalten: Ein Tag-Absatz mit einem Abschnittsumbruch wird geleert statt entfernt, eine Tabellenzelle oder Textbox, deren Absätze alle Tags waren, behält einen leeren Absatz, und eine Tabelle, die ohne Zeilen bleibt (eine Schleife über eine leere Liste), verschwindet.
• Eine Schleife kann keine Fußnoten, Endnoten oder Kommentare wiederholen (office-reference-in-loop). Nehmen Sie sie aus der Schleife heraus.

Was sich nicht als Vorlage nutzen lässt

Im Dokument	Was passiert	Code
Ein Tag, das über einen Absatz, eine Tabellenzelle, einen Hyperlink, ein Inhaltssteuerelement, ein Feld oder eine nachverfolgte Änderung hinausgeht	Abgelehnt: Das Tag lässt sich nicht zusammenfügen, ohne Text aus seinem Element zu verschieben. Tippen Sie das Tag neu, sodass es im selben Element beginnt und endet.	office-tag-spans-elements
Ein Tag in einem Feldcode (Seitenzahlen, HYPERLINK, INCLUDETEXT, …)	Bleibt, wie es ist, mit einer Warnung. Felder behalten ihre Funktion; gefüllt wird nur sichtbarer Text.	office-tag-in-field
Ein Tag in der Adresse eines Links, der über den Link-Dialog von Word eingefügt wurde	Bleibt, wie es ist.	—
Nachverfolgte Änderungen	Tags in eingefügtem Text werden gefüllt, gelöschter Text wird ignoriert, und die Änderungsmarkierungen bleiben. Nehmen Sie vor dem Hochladen alle Änderungen an.	—
{% include %}, {% render %}, {% extends %}, {% import %}, {% from %}, {{> partial }}	Abgelehnt: Partials enthalten HTML, das eine Word- oder PowerPoint-Datei nicht enthalten kann. Nutzen Sie die Kopf- und Fußzeilen und Schnellbausteine von Word.	unsupported-in-office

Die Seite der Vorlage listet diese Befunde je Teil und Absatz. Ein Fehler bricht das Rendering mit template_syntax_error oder unsupported_in_office ab, und location im Problem nennt statt Zeile und Spalte den Teil und den Absatz:

{
  "type": "https://docs.formfeed.dev/errors/template-syntax",
  "title": "Template syntax error",
  "status": 422,
  "detail": "word/document.xml: The tag {{ customer.name }} is split across a paragraph, a link, a field or a tracked change. Retype it in one go.",
  "code": "template_syntax_error",
  "location": { "part": "word/document.xml", "paragraph": 3 },
  "request_id": "req_3f9a1c2e7b4d40a8b6e1c0d9a2"
}

Der Teil ist die Datei im Dokument: word/document.xml ist der Haupttext, word/header2.xml eine Kopfzeile, ppt/slides/slide3.xml die dritte Folie. Absätze werden innerhalb dieses Teils ab 1 gezählt, so wie das Panel Tags sie nummeriert (¶3).

Wo Tags gefüllt werden

• Word: der Haupttext (einschließlich Textboxen), alle Kopf- und Fußzeilen, Fußnoten und Endnoten.
• PowerPoint: alle Folien mit ihren Textfeldern und Tabellen sowie die Notizen.

Tags an jeder anderen Stelle bleiben, wie sie getippt sind: in Kommentaren, Diagrammen, SmartArt und den Dokumenteigenschaften von Word und auf den Folienmastern und Layouts von PowerPoint.

Helper

Die Helper, die Text liefern, funktionieren wie in HTML-Vorlagen: money, date, number, t, numToWords und die übrigen, mit Gebietsschema, Zeitzone und Währung der Vorlage. nl2br und safe liefern den einfachen Text (ein Zeilenumbruch darin wird zum Zeilenumbruch im Dokument), und asset liefert die Adresse einer Datei aus der Bibliothek als Text.

Helper, die etwas zeichnen, fügen ein Bild ein:

Helper	Im Dokument
qrcode, epcQr	Ein QR-Code oder GiroCode. size setzt Breite und Höhe; ohne size hat der Code seine eigene Größe (160 px).
barcode	Ein Barcode in seiner natürlichen Größe, die height, width und scale des Helpers bestimmen.
image	Das Bild unter einer https:-Adresse, einer Data-URI oder einem Namen aus der Dateibibliothek. width und height setzen die Größe, alt wird zum Alternativtext des Bildes. fit wirkt in einem Dokument nicht.
pageBreak	Ein Seitenumbruch (nur Word).

Jinja2

{{ qrcode(offer.url, { size: 96 }) }}
{{ image(customer.logo, { width: "40mm" }) }}
{{ epcQr({ name: company.name, iban: company.iban, amount: offer.total, reference: offer.number }) }}

Liquid

{{ offer.url | qrcode: size: 96 }}
{{ customer.logo | image: width: "40mm" }}
{{ company.iban | epcQr: name: company.name, amount: offer.total, reference: offer.number }}

Handlebars

{{qrcode offer.url size=96}}
{{image customer.logo width="40mm"}}
{{epcQr name=company.name iban=company.iban amount=offer.total reference=offer.number}}

• Größen sind als Zahl Pixel bei 96 dpi, oder Längen mit Einheit: px, pt, mm, cm, in. Ist nur width oder height gesetzt, ergibt sich die andere aus dem Seitenverhältnis. Ohne Größe hat ein Bild seine natürliche Größe, und in Word ist es nie breiter als die Textspalte.
• Bilder lädt Formfeed mit denselben Prüfungen wie in HTML-Vorlagen: nur https:-Adressen, und private und interne Adressen werden abgelehnt. PNG und JPEG kommen unverändert ins Dokument; SVG (jeder Code ist eines), WebP, GIF und AVIF werden zuerst als PNG gezeichnet.
• Ein Bild, das sich nicht laden lässt, fehlt im Ergebnis. Das Rendering gelingt trotzdem, und seine Antwort erwähnt es nicht; die Schnellvorschau und formfeed render führen es als Warnung auf. Probieren Sie neue Daten also zuerst dort aus.
• Ein Dokument kann höchstens 50 Bilder, Codes und Seitenumbrüche mit zusammen 20 MB Bilddaten enthalten (office_document_too_large).
• chart und markdown liefern HTML und werden in Office-Vorlagen nicht unterstützt (unsupported-in-office).

Das Brand Kit steht als brand bereit: {{ brand.legal_footer }} in einer Fußzeile, {{ image(brand.logo.primary, { height: "12mm" }) }} für das Logo.

PowerPoint

Präsentationen folgen denselben Regeln, mit diesen Unterschieden:

• Eine Folie kann kein Bild im Text enthalten, deshalb wird ein Code oder Bild zu einer Bildform. Ein Textfeld, das nur den Helper enthält, wird durch das Bild ersetzt und in seinem Rahmen platziert: Zeichnen Sie ein Textfeld, wo der Code hin soll, und tippen Sie {{ qrcode(offer.url) }} hinein. Ohne eigene Größe oder mit einer, die größer ist als der Rahmen, wird das Bild in den Rahmen eingepasst und behält sein Seitenverhältnis; mehrere Bilder in einem Rahmen teilen ihn sich von oben nach unten. In einem Textfeld, das mit seinem Text wächst (die Voreinstellung von PowerPoint für neue Textfelder), zählt nur die Breite des Rahmens. Enthält das Textfeld auch Text, bleibt der Text, und das Bild liegt über dem Rahmen. Ein Platzhalter, dessen Position aus dem Folienlayout kommt, setzt das Bild in die Mitte der Folie.
• pageBreak hat auf einer Folie keine Bedeutung und entfällt.
• Schleifen wiederholen Absätze in einem Textfeld und Zeilen einer Tabelle. Ganze Folien lassen sich nicht wiederholen.
• Die Schnellvorschau gibt es nur für Word; Präsentationen prüfen Sie mit der PDF-Vorschau.

Die Seite der Office-Vorlage

Office-Vorlagen öffnen statt des Code-Editors eine eigene Seite. Das Dokument wird in Ihrem Browser analysiert, sodass die Panels sich aktualisieren, sobald Sie eine Datei wählen. Links gibt es sechs Panels:

Panel	Was es tut
Datei	Das Dokument mit seiner Größe. Datei ersetzen… wählt ein neues Dokument (hochgeladen, wenn Sie die nächste Version speichern; Gespeicherte Datei behalten nimmt die Wahl zurück), Herunterladen holt das aktuelle. Bei Word listet Schriften die Schriften, die das Dokument nennt, markiert eingebettete und vermerkt jede Schrift, die der Konverter ersetzen wird.
Tags	Alle Tags, gruppiert nach Teil (Dokument, Kopfzeile, Fußzeile, Fußnoten, Endnoten, Folie, Notizen) mit Absatznummer, und die Befunde der Prüfungen oben. Von hier kopieren Sie ein Tag.
Daten	Die Datensätze als JSON und das Schema. Einfügen im Schema kopiert das Tag des Felds, bereit zum Einfügen in Word oder PowerPoint.
Einstellungen	Ausgabe, wenn ein Rendering keine angibt (das eigene Format der Vorlage oder PDF) sowie Gebietsschema, Zeitzone und Währung für die Helper. Papier, Ränder, Kopf- und Fußzeilen kommen aus dem Dokument.
Versionen	Gespeicherte Versionen und Release Channels, wie bei HTML-Vorlagen.
API	Die Anfrage, die diese Vorlage rendert, in acht Sprachen, mit ihrem Slug und dem Datensatz, und eine Testanfrage, wie im API-Panel des Editors.

Version speichern und Veröffentlichen funktionieren wie im Editor. Rechts gibt es zwei Vorschauen:

• Schnellvorschau (nur Word) füllt das Dokument in Ihrem Browser und zeigt es als Webseite, sofort und annähernd: Word und das PDF können Zeilen und Seiten anders umbrechen. Zoomen Sie mit den Schaltflächen, Einpassen, Strg und dem Mausrad oder Strg mit +, - und 0; ein Klick auf die Prozentangabe führt zurück zu 100 %. Warnungen, etwa zu einem Bild, das sich nicht laden ließ, stehen über der Vorschau. Ausgefülltes Dokument lädt die ausgefüllte Datei herunter, ab dem Starter-Plan.
• PDF rendert die gespeicherte Datei mit den aktuellen Daten und Einstellungen auf unseren Servern und zeigt das PDF, das die API liefert. Wählen Sie Echtes Rendering. Das kostet nichts; im Free-Plan trägt das PDF die Testmarkierung. Eine ersetzte Datei muss vorher gespeichert sein.

Ausgaben

Eine Word-Vorlage rendert docx oder pdf, eine PowerPoint-Vorlage pptx oder pdf; jedes andere output beantwortet die API mit 400 invalid_request. Ohne output erzeugt ein Rendering settings.office.output, falls die Einstellungen der Anfrage oder der Vorlage es setzen, sonst das eigene Format der Vorlage:

curl https://api-eu.formfeed.dev/v1/renders \
  -H "Authorization: Bearer $FORMFEED_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "template": "offer",
    "data": { "customer": { "name": "Olvarest GmbH" } },
    "output": "pdf"
  }'

Die Antwort ist ein Rendering wie bei jeder Vorlage (Rendern). Eine docx- oder pptx-Ausgabe hat keinen page_count, weil Word und PowerPoint die Seiten selbst umbrechen.

Das PDF wandelt LibreOffice aus dem ausgefüllten Dokument um; Seiteneinrichtung, Kopf- und Fußzeilen und Seitenzahlen kommen also aus der Datei. Vor der Umwandlung werden Verknüpfungen zu Bildern oder Dateien außerhalb des Dokuments (in Word Mit Datei verknüpfen) entfernt, weil der Konverter nichts lädt; Hyperlinks bleiben. pdf.metadata.author, subject und keywords aus den Einstellungen werden in das PDF geschrieben; pdf.metadata.title wird für Office-Vorlagen nicht verwendet.

Post-Processing (Zusammenführen, Wasserzeichen, Passwort) und die PDF-Tools arbeiten mit diesem PDF; bei einer docx- oder pptx-Ausgabe beantwortet die API post mit 400 invalid_request. Das PDF kann wie das PDF einer HTML-Vorlage eine ZUGFeRD- oder Factur-X-E-Rechnung sein: Legen Sie einvoice in den Einstellungen der Vorlage fest oder senden Sie post.einvoice, mit dem _invoice-Block in den Daten. Eine PDF/UA-1-Datei kann es nicht sein: pdf.ua an einer Office-Vorlage beantwortet die API mit 400 invalid_request, eine E-Rechnung aus einer Word-Vorlage ist also ein PDF/A-3b ohne PDF/UA-1. Um eine docx- oder pptx-Ausgabe später umzuwandeln, übergeben Sie ihre Rendering-ID an /pdf/convert.

Ausgefüllte Dokumente werden immer als Anhang heruntergeladen. html- und url-Quellen können kein docx oder pptx erzeugen.

Schriften

Das PDF ist nur so genau wie die Schriften, die der Konverter hat. Installiert sind diese Familien:

• Carlito, Caladea sowie Liberation Sans, Serif und Mono;
• die DejaVu-Familien (Sans, Serif, Mono und ihre schmalen und leichten Schnitte);
• Noto Sans, Noto Serif und Noto Mono mit den Noto-Familien für fast jede andere Schrift, darunter CJK (Chinesisch, Japanisch, Koreanisch), Arabisch, Hebräisch, Devanagari und Thai, dazu Noto Color Emoji und OpenSymbol.

Eine Schrift, die das Dokument mit einem dieser Namen nennt, wird so verwendet. Schriften, die das Dokument weder einbettet noch dort findet, werden ersetzt:

• Calibri, Cambria, Arial, Helvetica, Times New Roman und Courier New werden durch metrisch kompatible Schriften ersetzt (Carlito, Caladea, Liberation); Zeilen und Seiten brechen also gleich um.
• Jede andere Schrift, auch Aptos, seit 2024 die Standardschrift von Office, wird durch eine Schrift mit anderen Maßen ersetzt, und das PDF kann anders aussehen als in Word. Das Panel Datei warnt bei jeder davon.

Für ein exaktes PDF betten Sie die Schriften in das Dokument ein: in Word unter Datei › Optionen › Speichern › Schriftarten in der Datei einbetten. Die hochgeladenen Schriften der Organisation werden nicht automatisch in Office-Dokumente eingebettet.

Pläne, Einheiten und Limits

Pläne	Live-Renderings von Office-Vorlagen, der Download Ausgefülltes Dokument in der App und die Office-Umwandlung setzen den Starter-Plan oder höher voraus; im Free-Plan antwortet ein Live-Rendering mit 403 forbidden und "feature": "office". Free-Workspaces können Office-Vorlagen anlegen (im Rahmen der fünf Vorlagen des Plans) und als PDF mit Testmarkierung test-rendern. Ein Test-Rendering, das dort docx oder pptx anfordert, beantwortet die API mit 403 test_output_unavailable.
Einheiten	Eine docx- oder pptx-Ausgabe kostet 1 Einheit. Eine PDF-Ausgabe folgt der PDF-Regel, 1 Einheit je angefangene 5 Seiten. Test-Schlüssel kosten nichts. Siehe Einheiten.
Vorlagendatei	20 MB (file_too_large); darin höchstens 2.000 Teile, 200 MB entpackt und 20 MB für einen einzelnen Teil (office_document_invalid oder office_document_too_large).
Ausgefülltes Dokument	50 MB vor der Kompression, 50 Bilder, Codes und Seitenumbrüche, 20 MB Bilddaten (office_document_too_large). Für jede Ausgabe gilt die Größengrenze des Plans (output_too_large).
Seiten	Für das PDF gilt das Seitenlimit des Plans (page_limit_exceeded).
Zeit	Das Füllen des Dokuments darf 10 Sekunden dauern, das ganze Rendering einschließlich der Umwandlung 60 Sekunden (render_timeout).

Vorlagen als Code

In einem Projekt ist eine Office-Vorlage ein Ordner mit template.json ("kind": "docx" oder "pptx"), template.docx oder template.pptx und den üblichen data/, schema.json und settings.json.

• formfeed templates pull lädt das Dokument der geholten Version herunter; push lädt es nur hoch, wenn sich sein Inhalt seit dem letzten Abgleich geändert hat.
• formfeed validate und formfeed dev listen die Befunde je Teil und Absatz.
• formfeed render füllt das Dokument auf Ihrem Rechner und schreibt das docx oder pptx; für PDF wandelt es die ausgefüllte Datei über /pdf/convert um, was den Starter-Plan voraussetzt. Dieses PDF ist ein einfaches: Eine E-Rechnung, die die Einstellungen festlegen, erzeugt erst die hochgeladene Vorlage, mit formfeed render --remote.
• formfeed dev hat keine lokale Vorschau eines Word- oder PowerPoint-Dokuments. Drücken Sie einmal True render; ab dann wandelt es bei jedem Speichern um und zeigt das PDF neu.
• formfeed test hält das ausgefüllte XML jedes Teils als Snapshot in tests/__snapshots__/<Datensatz>.xml fest, sodass ein Diff zeigt, was sich geändert hat. Bilder gehören nicht zum Snapshot.

Codes und SVG-Bilder werden lokal gezeichnet, wenn das optionale Paket @resvg/resvg-js neben der CLI installiert ist (npm install -g @resvg/resvg-js für eine global installierte CLI); WebP-, GIF- und AVIF-Bilder entfallen lokal mit einer Warnung, weil nur die API sie zeichnet.

Fehler

Code	Status	Wann
template_syntax_error	422	Ein Tag lässt sich nicht lesen, oder eine der Prüfungen oben ist fehlgeschlagen. location nennt Teil und Absatz.
template_runtime_error	422	Ein Tag ist mit diesen Daten fehlgeschlagen.
unsupported_in_office	422	Ein Include, ein Partial, chart oder markdown.
office_document_too_large	422	Die Datei, das ausgefüllte Dokument oder seine Bilder überschreiten die Limits.
office_document_invalid	422	Die Datei ist beschädigt oder besteht die Sicherheitsprüfungen nicht.
source_encrypted	422	Die hochgeladene Datei ist passwortgeschützt.
file_type_unsupported	415	Der Upload ist keine Word- oder PowerPoint-Datei der Art der Vorlage, oder er enthält Makros.
file_too_large	413	Die Vorlagendatei ist größer als 20 MB.
forbidden	403	Ein Live-Rendering oder eine Umwandlung über /pdf/convert in einem Plan ohne Office-Dokumente ("feature": "office").
test_output_unavailable	403	Ein Test-Rendering im Free-Plan hat docx oder pptx angefordert.
invalid_request	400	Ein output, das die Art der Vorlage nicht erzeugen kann, post bei einer docx- oder pptx-Ausgabe, pdf.ua oder eine Office-Vorlage ohne file angelegt.
output_too_large	422	Die Ausgabe ist größer, als der Plan erlaubt.
page_limit_exceeded	422	Das PDF hat mehr Seiten, als der Plan erlaubt.
source_invalid	422	Der Konverter konnte das ausgefüllte Dokument nicht lesen.
office_conversion_failed	422	Das ausgefüllte Dokument ließ sich nicht in PDF umwandeln.
render_timeout	504	Das Füllen hat länger als 10 Sekunden gedauert, oder das ganze Rendering länger als 60.
office_unavailable	503	Der Konverter ist ausgelastet oder nicht erreichbar; wiederholen Sie nach Retry-After.