Autype
Zurück zum Blog

Aktualisiert 21. November 2026

Querverweise und Nummerierung: Dokumente, die nach jeder Änderung noch stimmen

Handgeschriebene Verweise veralten beim ersten erneuten Rendern. Wie Anker, Nummerierung zur Renderzeit und generierte Verzeichnisse Dokumente nach jeder Änderung korrekt halten – mit vier Prüftests.

DokumentenautomatisierungTutorials#document automation#cross-references#numbering#indices#markdown

Ein Wartungsvertrag mit sechs Anhängen verlässt das Haus. Drei Wochen später streicht der Kunde ein Modul, der Vertrag wird neu erzeugt – und auf Seite 12 steht weiterhin „siehe Anhang E, Reaktionszeiten“. Die Reaktionszeiten stehen inzwischen in Anhang D. Niemand hat getippt, niemand hat etwas übersehen: Der Satz war beim ersten Rendern richtig und ist beim zweiten falsch.

Solche Fehler überstehen jede Textprüfung, weil der Satz plausibel klingt. Sie fallen beim Kunden auf, in der Revision oder im Audit. Dieser Beitrag zeigt, warum handgeschriebene Nummern in automatisch erzeugten Dokumenten systematisch veralten – und wie Querverweise, Nummerierung und Verzeichnisse aus der Quelle statt aus dem fertigen PDF kommen. Die Beispiele nutzen Autype; die Prüfliste am Ende gilt für jede Pipeline.

Drei Arten, wie Nummern verrutschen

FehlerbildUrsacheWoran es auffällt
„Siehe Abschnitt 4.2“ zeigt auf die falsche StelleNummer beim Schreiben abgetippt, später kam ein Kapitel hinzuWer dem Verweis folgt, landet bei „Kündigung“ statt bei „Gewährleistung“
Abbildung 3 existiert zweimalBildunterschrift mit Nummer kopiert, Bild ausgetauschtZwei gleiche Nummern im Dokument, eine fehlt im Verzeichnis
Seitenzahlen im Inhaltsverzeichnis stimmen nichtVerzeichnis von Hand gepflegt, danach Text ergänztAnhang beginnt laut Verzeichnis auf Seite 11, tatsächlich auf Seite 13
Nummerierung reißt bei einer Variante abVorlage pro Kunde kopiert, ein Modul gestrichenAnhang A, B, D – C fehlt ohne Erklärung

Gemeinsam ist allen vier Fällen: Die Nummer war eine redaktionelle Entscheidung. Sie hätte eine Rechenaufgabe sein müssen.

Anker statt Positionen

Autype löst das über Anker. Überschriften bekommen eine ID im Text, Bilder, Charts, Tabellen und Code-Listings ein anchor-Attribut. Die ID beschreibt das Element, nicht seinen Platz:

## Reaktionszeiten {#sec-reaktion}

![Eskalationsstufen im Störungsfall](eskalation.png){anchor=fig-eskalation caption="Eskalationsstufen"}

:::table{caption="Service-Level je Modul" anchor=tab-sla}
| Modul | Erstreaktion | Entstörung |
|---|---|---|
| Basis | 8 Geschäftsstunden | 2 Geschäftstage |
| Plus | 4 Geschäftsstunden | 1 Geschäftstag |
:::

Im Fließtext steht dann keine Zahl, sondern der Verweis:

Die Fristen in [Tabelle {num}](#tab-sla) gelten ab Eingang der Störungsmeldung.

{num} wird beim Rendern durch die tatsächliche Tabellennummer ersetzt. Wandert die Tabelle nach hinten, weil vorn ein neuer Abschnitt eingefügt wurde, ändert sich die Ausgabe – der Quelltext bleibt unverändert. Der Anker tab-sla bleibt stabil, auch wenn aus der Tabelle 2 eine Tabelle 4 wird. Wie die drei Anzeigemodi im Detail funktionieren, steht in der Dokumentation zu References & Anchors.

Das Prinzip ist nicht neu. LaTeX arbeitet seit Jahrzehnten mit \label und \ref, und die Overleaf-Dokumentation weist darauf hin, dass lokale LaTeX-Läufe das Dokument zweimal kompilieren müssen, damit Verweise aufgelöst werden. Der Unterschied liegt im Aufwand: Eine Markdown-Quelle mit Anker-IDs bleibt lesbar, und die Nummer entsteht in dem Schritt, in dem auch das PDF entsteht.

Drei Schreibweisen für denselben Verweis

Wie ein Verweis im Satz klingt, ist eine Stilfrage. Autype bietet dafür drei Modi:

ModusSchreibweiseAusgabePasst zu
Automatisch[](#sec-reaktion)„Abschnitt 2.1 Reaktionszeiten“Erstnennung im Fließtext, wenn der Titel hilft
Platzhalter[Abschnitt {num}](#sec-reaktion)„Abschnitt 2.1“Sätzen, in denen der Titel ohnehin im Nebensatz steht
Freier Text[die Reaktionszeiten](#sec-reaktion)„die Reaktionszeiten“Zusammenfassungen, in denen eine Zahl den Satz schwer macht

Die Wahl beeinflusst nicht die Korrektheit, sondern die Lesbarkeit. Ein Dokument, in dem in jedem zweiten Absatz „siehe Abschnitt 3.4“ steht, liest sich wie ein Behördenerlass. Wechsle bewusst: Zahlen dort, wo der Leser sie zum Blättern braucht; freier Text dort, wo der Satz sonst stolpert.

Verzeichnisse, die aus dem Inhalt entstehen

Dieselbe Logik gilt für die Verzeichnisse. Sie werden nicht gepflegt, sondern erzeugt – die vollständige Liste steht in der Dokumentation zu automatischen Verzeichnissen:

AnweisungSammeltVoraussetzung
::tocÜberschriften bis zur eingestellten Ebenekeine
::lofBilder und ChartsAlternativtext oder caption
::lotTabellencaption im Tabellen-Direktiv
::locCode-Listingscaption am Codeblock
::loaAbkürzungenim Text markierte Abkürzungen

Zwei Details entscheiden in der Praxis darüber, ob das Verzeichnis vollständig ist. Erstens: Was keine Bildunterschrift hat, taucht nicht auf. Die Bildunterschrift ist damit kein Schmuck, sondern der Vertrag mit dem Verzeichnis. Zweitens: Diagramme mit Bildunterschrift zählen als Abbildungen und erscheinen im Abbildungsverzeichnis, nicht im Quellcodeverzeichnis. Wer Mermaid-Diagramme und Codeblöcke gemischt hat, sollte das vor der Abnahme wissen.

Beim DOCX-Export bleibt ein Punkt bestehen, den auch andere Systeme kennen: Das Inhaltsverzeichnis wird als Feld ausgegeben. Word und LibreOffice füllen die Seitenzahlen erst nach dem Aktualisieren der Felder. Für die PDF-Fassung ist das irrelevant; für die DOCX-Fassung gehört der Feld-Update in die Prüfliste.

Prüfen statt hoffen

Der interessanteste Teil ist die Fehlerbehandlung. Autype validiert Verweise beim Rendern: doppelte Anker und Verweise auf nicht existierende Anker führen zu einem Validierungsfehler. Ein Dokument, das auf eine gelöschte Abbildung zeigt, wird nicht stillschweigend ausgeliefert – es bricht ab.

Das ist der Unterschied zwischen einem Warnhinweis und einer Sperre. Wer schon einmal ein Angebot verschickt hat, in dem „siehe Anlage 2“ stand, ohne dass es eine Anlage 2 gab, weiß, warum das zählt.

Vier Tests decken die meisten Fälle ab:

TestVorgehenErwartetes Ergebnis
Abschnitt einfügenNeuen Abschnitt vor Anhang D setzenNachfolgende Verweise und Verzeichnisnummern ändern sich ohne Handarbeit
Ziel löschenAbbildung entfernen, auf die verwiesen wirdRender bricht mit Validierungsfehler ab, statt eine leere Nummer zu liefern
Variante erzeugenKurz- und Langfassung des Vertrags rendernJede Fassung nummeriert ihre eigenen Elemente – keine Lücke, keine Dopplung
DOCX öffnenExport öffnen und Felder aktualisierenInhaltsverzeichnis zeigt Seitenzahlen, die zur Datei passen

Test drei wird in der Praxis am häufigsten übersehen. Zwei Varianten desselben Dokuments sind zwei Dokumente. Wer erwartet, dass Anhang C in beiden Fassungen dieselbe Nummer trägt, verlangt von der Nummerierung etwas, das sie nicht leisten kann: die Gleichzeitigkeit zweier Reihenfolgen. Richtig ist, dass jede Fassung intern konsistent ist. Wie sich solche Änderungen zusätzlich absichern lassen, beschreibt der Beitrag Regressionstests für PDF- und DOCX-Vorlagen.

Wo die Grenze liegt

Anker sind dokumentlokal. Ein Verweis von einem PDF in ein anderes löst dieses Verfahren nicht; dafür braucht es eine stabile Kennung im Dateinamen oder in den Metadaten.

Anker-IDs sind technische Namen. Wer sie in Freigaben, Tickets oder externen Verweisen zitiert, sollte sie nicht umbenennen. tab-sla bleibt tab-sla, auch wenn das Wort „SLA“ später aus der Überschrift verschwindet. Die ID ist ein Griff, kein Etikett.

Und die Nummerierung folgt der Reihenfolge im Dokument, nicht der Reihenfolge im Gespräch. Wenn das Kapitel „Datenschutz“ ans Ende wandert, wird es zu Kapitel 7 statt 3. Das ist kein Fehler, sondern der Zweck der Übung.

Wann sich das lohnt

Sobald ein Dokument mehr als zehn interne Verweise hat, in Varianten erzeugt wird oder durch eine Freigabe geht, ist Handarbeit teurer als die einmalige Einrichtung. Bei einem zweiseitigen Anschreiben mit einem Verweis wäre der Aufwand übertrieben.

Die Faustregel: Wenn ein Dokument nach dem Rendern noch von jemandem gelesen wird, der die Quelle nicht kennt, müssen Nummern aus der Quelle kommen. Alles andere ist eine Wette darauf, dass sich nichts mehr ändert. Wer die Automatisierung ohnehin über die Engine betreibt, findet die Export- und PDF-Optionen unter autype.com/document-engine; die Preisstaffelung steht unter autype.com/pricing.

Quellen und Abrufdatum

Autype: References & Anchors — https://docs.autype.com/markup-reference/references — abgerufen am 21.11.2026.

Autype: Automatic Indices — https://docs.autype.com/markup-reference/indices — abgerufen am 21.11.2026.

Overleaf: Cross referencing sections, equations and floats — https://www.overleaf.com/learn/latex/Cross_referencing_sections%2C_equations_and_floats — abgerufen am 21.11.2026.

Bereit, deine Dokumente zu automatisieren?

Erstelle Geschäftsdokumente mit Autype. Keine Kreditkarte nötig.