Ein professioneller Report braucht mehr als nur Inhalt - er braucht Struktur. In diesem Kapitel lernt man, wie man ein Inhaltsverzeichnis hinzufügt, Seitenumbrüche einfügt und das Seitenlayout für breite Tabellen oder Grafiken auf Querformat umstellt.

Inhaltsverzeichnis

Einfaches TOC aktivieren

Ein Inhaltsverzeichnis wird im YAML-Header aktiviert:

---
title: "Pinguin-Report"
format:
  docx:
    toc: true
---

Word fügt automatisch ein Inhaltsverzeichnis am Anfang des Dokuments ein, basierend auf den Überschriften.

TOC-Tiefe einstellen

Standardmäßig werden drei Überschriftsebenen angezeigt. Das lässt sich anpassen:

format:
  docx:
    toc: true
    toc-depth: 2

toc-depth	Angezeigte Ebenen
1	Nur `#`
2	`#` und `##`
3	`#`, `##` und `###` (Standard)

TOC-Titel ändern

format:
  docx:
    toc: true
    toc-title: "Inhaltsverzeichnis"

Seitenumbrüche

Der pagebreak Shortcode

Um einen Seitenumbruch einzufügen, verwendet man den pagebreak Shortcode:

# Einleitung

Text der Einleitung...



# Methoden

Text der Methoden...

Das ist nützlich, um sicherzustellen, dass ein neues Kapitel auf einer neuen Seite beginnt.

Automatische Seitenumbrüche vor Überschriften

Für automatische Seitenumbrüche vor jeder Hauptüberschrift kann man das Word-Template anpassen (Kapitel 4): In der Formatvorlage “Überschrift 1” unter Format → Absatz → Zeilen- und Seitenumbruch die Option “Seitenumbruch oberhalb” aktivieren.

Querformat (Landscape)

Manchmal sind Tabellen oder Grafiken zu breit für das Hochformat. Mit dem officedown-Paket kann man einzelne Seiten ins Querformat drehen.

officedown einrichten

Zuerst muss das Paket installiert sein:

install.packages("officedown")

Officedown wurde ursprünglich für RMarkdown entwickelt. Um es aus Quarto heraus zu nutzen, rendert man die Datei mit knitr als Engine und übergibt rdocx_document über den output-Mechanismus:

---
title: "Pinguin-Report"
knitr:
  opts_chunk:
    echo: false
output:
  officedown::rdocx_document:
    reference_docx: template.docx
---

Das Dokument wird dann mit rmarkdown::render() statt mit quarto render gerendert. Quartos eigenes format: docx stellt die officedown-Features (Landscape-Blöcke, abschnittsweise Seitengrößen) aktuell nicht bereit.

Hinweis

Die Integration von officedown in Quarto ist noch umständlich - daher behandeln wir es als Notlösung für Fälle, in denen Quartos native DOCX-Unterstützung nicht ausreicht. Für einfache Anforderungen kann man die breite Tabelle in Word manuell drehen oder auf mehrere Seiten aufteilen.

Landscape-Blöcke

Mit officedown kann man einzelne Abschnitte ins Querformat setzen:

<!---BLOCK_LANDSCAPE_START--->

```{r}
#| label: wide-table
# Sehr breite Tabelle hier


Alles zwischen `BLOCK_LANDSCAPE_START` und `BLOCK_LANDSCAPE_STOP` erscheint im Querformat.

# Seitenränder

## Im YAML-Header

Für PDF/LaTeX-Output lassen sich Seitenränder über `geometry` im YAML-Header definieren:

```yaml
format:
  pdf:
    geometry:
      - top=2.5cm
      - bottom=2.5cm
      - left=3cm
      - right=2.5cm

Warnung

Der geometry-Key ist eine LaTeX-Option und wird beim Rendern nach DOCX ignoriert. Für Word-Dokumente müssen die Seitenränder im Reference-Template gesetzt werden.

Tipp

Die zuverlässigste Methode für Seitenränder in DOCX ist, sie im Word-Template (Kapitel 4) einzustellen: Layout → Seitenränder → Benutzerdefinierte Seitenränder.

Kopf- und Fußzeilen

Kopf- und Fußzeilen werden über das Word-Template gesteuert:

Template in Word öffnen
Doppelklick auf Kopf- oder Fußzeile
Gewünschten Text/Seitenzahlen einfügen
Template speichern

Quarto übernimmt diese Einstellungen beim Rendern.

Seitenzahlen

Im Word-Template:

Fußzeile öffnen
Einfügen → Seitenzahl
Position und Format wählen
Template speichern

Abschnitte mit unterschiedlichen Layouts

Für komplexere Dokumente mit verschiedenen Layouts (z.B. Titelseite ohne Seitenzahl, Hauptteil mit Seitenzahlen) muss man mit Word-Abschnittswechseln im Template arbeiten. Das geht über den Rahmen dieses Tutorials hinaus, ist aber in der officedown-Dokumentation beschrieben.

Praktisches Beispiel

Hier ist ein vollständiges YAML-Setup für einen professionellen Report:

---
title: "Analyse der Adelie-Pinguine"
author: "Forschungsteam"
date: today
lang: de
format:
  docx:
    reference-doc: templates/vorlage.docx
    toc: true
    toc-depth: 2
    toc-title: "Inhaltsverzeichnis"
crossref:
  fig-title: "Abbildung"
  tbl-title: "Tabelle"
  fig-prefix: "Abb."
  tbl-prefix: "Tab."
execute:
  echo: false
  warning: false
  message: false
---

Das Officeverse-Ökosystem

Für fortgeschrittene Word-Dokumente gibt es das “Officeverse” - eine Sammlung von R-Paketen:

Paket	Zweck
flextable	Tabellen (bereits behandelt)
officedown	Erweiterte Word-Features in R Markdown/Quarto
officer	Word-Dokumente programmatisch erstellen
mschart	Native Word-Diagramme

Wann officer statt Quarto?

Sehr komplexe Layouts, die Quarto nicht unterstützt
Massenproduktion von Dokumenten (z.B. 100 personalisierte Reports)
Volle programmatische Kontrolle über jedes Element

Für die meisten wissenschaftlichen Reports ist Quarto mit flextable aber völlig ausreichend.

Übung: Report-Struktur aufbauen

Erstelle ein Dokument mit mindestens drei Hauptkapiteln
Aktiviere das Inhaltsverzeichnis mit toc: true
Füge vor dem ersten Hauptkapitel einen Seitenumbruch ein
Experimentiere mit verschiedenen toc-depth Einstellungen
Rendere zu Word und prüfe das Ergebnis

Weiterführende Ressourcen

Quarto Word Options - Alle YAML-Optionen
officedown - Erweiterte Features
officer - Programmatische Dokumenterstellung

Was kommt als Nächstes

In Kapitel 9 lernen wir, wie man Zitationen und eine Bibliografie in das Dokument einfügt - essentiell für wissenschaftliche Publikationen.

Zitat

Mit BibTeX zitieren:

@online{schmidt2026,
  author = {{Dr. Paul Schmidt}},
  publisher = {BioMath GmbH},
  title = {8. Inhaltsverzeichnis und Seitenlayout},
  date = {2026-06-08},
  url = {https://biomathcontent.netlify.app/de/content/quarto/08_toc_and_layout.html},
  langid = {de}
}

Bitte zitieren Sie diese Arbeit als:

Dr. Paul Schmidt. 2026. “8. Inhaltsverzeichnis und Seitenlayout.” BioMath GmbH. June 8, 2026. https://biomathcontent.netlify.app/de/content/quarto/08_toc_and_layout.html.

--- title: "8. Inhaltsverzeichnis und Seitenlayout" subtitle: "TOC, Seitenumbrüche und Querformat" --- Ein professioneller Report braucht mehr als nur Inhalt - er braucht Struktur. In diesem Kapitel lernt man, wie man ein Inhaltsverzeichnis hinzufügt, Seitenumbrüche einfügt und das Seitenlayout für breite Tabellen oder Grafiken auf Querformat umstellt. ```{r} #| label: qrt-layout-setup #| include: false library(tidyverse) library(palmerpenguins) library(flextable) adelie <- penguins %>% filter(species == "Adelie") %>% drop_na() ``` # Inhaltsverzeichnis ## Einfaches TOC aktivieren Ein Inhaltsverzeichnis wird im YAML-Header aktiviert: ```yaml --- title: "Pinguin-Report" format: docx: toc: true --- ``` Word fügt automatisch ein Inhaltsverzeichnis am Anfang des Dokuments ein, basierend auf den Überschriften. ## TOC-Tiefe einstellen Standardmäßig werden drei Überschriftsebenen angezeigt. Das lässt sich anpassen: ```yaml format: docx: toc: true toc-depth: 2 ``` | toc-depth | Angezeigte Ebenen | |-----------|-------------------| | 1 | Nur `#` | | 2 | `#` und `##` | | 3 | `#`, `##` und `###` (Standard) | ## TOC-Titel ändern ```yaml format: docx: toc: true toc-title: "Inhaltsverzeichnis" ``` # Seitenumbrüche ## Der pagebreak Shortcode Um einen Seitenumbruch einzufügen, verwendet man den `pagebreak` Shortcode: ```markdown # Einleitung Text der Einleitung... {{< pagebreak >}} # Methoden Text der Methoden... ``` Das ist nützlich, um sicherzustellen, dass ein neues Kapitel auf einer neuen Seite beginnt. ## Automatische Seitenumbrüche vor Überschriften Für automatische Seitenumbrüche vor jeder Hauptüberschrift kann man das Word-Template anpassen (Kapitel 4): In der Formatvorlage "Überschrift 1" unter **Format → Absatz → Zeilen- und Seitenumbruch** die Option "Seitenumbruch oberhalb" aktivieren. # Querformat (Landscape) Manchmal sind Tabellen oder Grafiken zu breit für das Hochformat. Mit dem **officedown**-Paket kann man einzelne Seiten ins Querformat drehen. ## officedown einrichten Zuerst muss das Paket installiert sein: ```r install.packages("officedown") ``` Officedown wurde ursprünglich für RMarkdown entwickelt. Um es aus Quarto heraus zu nutzen, rendert man die Datei mit `knitr` als Engine und übergibt `rdocx_document` über den `output`-Mechanismus: ```yaml --- title: "Pinguin-Report" knitr: opts_chunk: echo: false output: officedown::rdocx_document: reference_docx: template.docx --- ``` Das Dokument wird dann mit `rmarkdown::render()` statt mit `quarto render` gerendert. Quartos eigenes `format: docx` stellt die officedown-Features (Landscape-Blöcke, abschnittsweise Seitengrößen) aktuell nicht bereit. :::{.callout-note} Die Integration von officedown in Quarto ist noch umständlich - daher behandeln wir es als Notlösung für Fälle, in denen Quartos native DOCX-Unterstützung nicht ausreicht. Für einfache Anforderungen kann man die breite Tabelle in Word manuell drehen oder auf mehrere Seiten aufteilen. ::: ## Landscape-Blöcke Mit officedown kann man einzelne Abschnitte ins Querformat setzen: ```markdown  ```{r} #| label: wide-table # Sehr breite Tabelle hier ```  ``` Alles zwischen `BLOCK_LANDSCAPE_START` und `BLOCK_LANDSCAPE_STOP` erscheint im Querformat. # Seitenränder ## Im YAML-Header Für PDF/LaTeX-Output lassen sich Seitenränder über `geometry` im YAML-Header definieren: ```yaml format: pdf: geometry: - top=2.5cm - bottom=2.5cm - left=3cm - right=2.5cm ``` :::{.callout-warning} Der `geometry`-Key ist eine LaTeX-Option und wird **beim Rendern nach DOCX ignoriert**. Für Word-Dokumente müssen die Seitenränder im Reference-Template gesetzt werden. ::: :::{.callout-tip} Die zuverlässigste Methode für Seitenränder in DOCX ist, sie im Word-Template (Kapitel 4) einzustellen: **Layout → Seitenränder → Benutzerdefinierte Seitenränder**. ::: # Kopf- und Fußzeilen Kopf- und Fußzeilen werden über das Word-Template gesteuert: 1. Template in Word öffnen 2. Doppelklick auf Kopf- oder Fußzeile 3. Gewünschten Text/Seitenzahlen einfügen 4. Template speichern Quarto übernimmt diese Einstellungen beim Rendern. ## Seitenzahlen Im Word-Template: 1. Fußzeile öffnen 2. **Einfügen → Seitenzahl** 3. Position und Format wählen 4. Template speichern # Abschnitte mit unterschiedlichen Layouts Für komplexere Dokumente mit verschiedenen Layouts (z.B. Titelseite ohne Seitenzahl, Hauptteil mit Seitenzahlen) muss man mit Word-Abschnittswechseln im Template arbeiten. Das geht über den Rahmen dieses Tutorials hinaus, ist aber in der officedown-Dokumentation beschrieben. # Praktisches Beispiel Hier ist ein vollständiges YAML-Setup für einen professionellen Report: ```yaml --- title: "Analyse der Adelie-Pinguine" author: "Forschungsteam" date: today lang: de format: docx: reference-doc: templates/vorlage.docx toc: true toc-depth: 2 toc-title: "Inhaltsverzeichnis" crossref: fig-title: "Abbildung" tbl-title: "Tabelle" fig-prefix: "Abb." tbl-prefix: "Tab." execute: echo: false warning: false message: false --- ``` # Das Officeverse-Ökosystem Für fortgeschrittene Word-Dokumente gibt es das "Officeverse" - eine Sammlung von R-Paketen: | Paket | Zweck | |-------|-------| | **flextable** | Tabellen (bereits behandelt) | | **officedown** | Erweiterte Word-Features in R Markdown/Quarto | | **officer** | Word-Dokumente programmatisch erstellen | | **mschart** | Native Word-Diagramme | **Wann officer statt Quarto?** - Sehr komplexe Layouts, die Quarto nicht unterstützt - Massenproduktion von Dokumenten (z.B. 100 personalisierte Reports) - Volle programmatische Kontrolle über jedes Element Für die meisten wissenschaftlichen Reports ist Quarto mit flextable aber völlig ausreichend. :::{.callout-tip collapse="false"} ## Übung: Report-Struktur aufbauen 1. Erstelle ein Dokument mit mindestens drei Hauptkapiteln 2. Aktiviere das Inhaltsverzeichnis mit `toc: true` 3. Füge vor dem ersten Hauptkapitel einen Seitenumbruch ein 4. Experimentiere mit verschiedenen `toc-depth` Einstellungen 5. Rendere zu Word und prüfe das Ergebnis ::: # Weiterführende Ressourcen - [Quarto Word Options](https://quarto.org/docs/reference/formats/docx.html) - Alle YAML-Optionen - [officedown](https://ardata-fr.github.io/officeverse/officedown-for-word.html) - Erweiterte Features - [officer](https://ardata-fr.github.io/officeverse/officer-for-word.html) - Programmatische Dokumenterstellung # Was kommt als Nächstes In Kapitel 9 lernen wir, wie man Zitationen und eine Bibliografie in das Dokument einfügt - essentiell für wissenschaftliche Publikationen.