Übung 10 - Ergebnisberichte in R: Quarto & Markdown
FS 2026
Author
Gidon Frischkorn
Wiederholung & Vertiefung: Reproduzierbare Berichte mit Quarto
In den bisherigen Sitzungen haben Sie Daten importiert, aufbereitet, deskriptiv zusammengefasst (Übung 7) und visualisiert (Übung 8). Die Ergebnisse standen dabei in der R-Konsole oder im Plots-Panel. Heute geht es um die Frage: Wie kommen diese Ergebnisse in einen Bericht?
Das Problem: Copy-Paste-Workflow
R → Screenshot → Word → Daten ändern → alles nochmal. Typische Fehlerquellen: falsche Versionen, nicht aktualisierte Tabellen, fehlende Nachvollziehbarkeit. Stellen Sie sich vor, Sie müssen nach der Analyse 3 Fälle ausschliessen. Jede Zahl und jeder Plot im Word-Dokument muss dann manuell aktualisiert werden.
Die Lösung: Quarto-Dokumente
Ein Quarto-Dokument (.qmd) vereint Text, R-Code und Ergebnisse in einer einzigen Datei. Der Bericht ist die Analyse. Beim Rendern wird der Code ausgeführt und ein fertiges Dokument (HTML, PDF oder Word) erzeugt. Ändern sich die Daten, genügt ein Klick auf „Render”, und alle Ergebnisse aktualisieren sich automatisch.
Figure 1: Quarto-Rendering-Workflow: Eine einzige .qmd-Quelldatei wird zu beliebigen Ausgabeformaten — Code und Ergebnisse bleiben immer synchron.
Drei Bausteine eines Quarto-Dokuments
Baustein
Funktion
Beispiel
YAML-Header
Metadaten (zwischen ---)
Titel, Autor, Ausgabeformat
Text (Markdown)
Formatierter Text
Überschriften, Listen, Fett/Kursiv
Code-Chunks
R-Code in abgegrenzten Blöcken
Analysen, Grafiken, Tabellen
Visual Editor und Source Editor
RStudio bietet zwei Ansichten für Quarto-Dokumente:
Visual Editor: WYSIWYG-Ansicht. Überschriften sehen wie Überschriften aus, fett ist fett. Toolbar für Formatierung wie in Word. Gut zum Einstieg.
Source Editor: Zeigt den Quellcode direkt — YAML, Markdown-Syntax (## Überschrift, **fett**), Code-Chunks mit Backticks. Wichtig für Fehlersuche.
Beide Ansichten bearbeiten dasselbe Dokument. Sie können jederzeit über den Button oben links im Editor umschalten. Im Visual Editor formatieren Sie wie in Word, im Source Editor sehen Sie die Syntax dahinter.
Chunk-Optionen
Chunk-Optionen stehen am Anfang eines Chunks mit #|:
Option
Wirkung
echo: true
Code wird angezeigt (Default)
echo: false
Code wird verborgen, Ergebnisse bleiben
eval: false
Code wird angezeigt, aber nicht ausgeführt
message: false
Meldungen werden unterdrückt
Wichtig: Auch bei echo: false bleibt der Code im Quelldokument erhalten. Verbergen ist nicht dasselbe wie Löschen. Die Zielgruppe bestimmt die Darstellung, nicht den Inhalt.
Inline-Code
R-Ausdrücke lassen sich direkt im Fliesstext einbetten. Beim Rendern wird der Ausdruck berechnet und als Zahl eingefügt. Es ist dieselbe Logik wie summarise() in Übung 7, nur direkt im Text.
Im Quarto-Quelltext schreiben Sie den R-Ausdruck mit Backtick, r, Leerzeichen und dem R-Ausdruck, abgeschlossen mit einem Backtick. Quellcode-Beispiel:
Der Mittelwert betrug `r round(mean(daten$wm_score_t1, na.rm = TRUE), 1)` Punkte.
Beim Rendern wird der Ausdruck berechnet und als Zahl eingefügt. Im gerenderten Text steht dann: „Der Mittelwert betrug 62.3 Punkte.”
Ausführungsreihenfolge
Chunks werden von oben nach unten ausgeführt. Datenimport und Pakete gehören an den Anfang des Dokuments. Ein häufiger Fehler: Eine Variable wird in einem späteren Chunk erstellt, aber in einem früheren verwendet. Das Ergebnis ist object not found.
Übungen
Beantworten Sie die folgenden Fragen zu reproduzierbaren Berichten mit Quarto.
In einem Quarto-Dokument stehen folgende drei Code-Chunks in dieser Reihenfolge:
Quarto führt Code-Chunks strikt sequentiell von oben nach unten aus. In Chunk 1 wird das Objekt daten benötigt, das aber erst in Chunk 2 erstellt wird. Daher bricht das Rendern mit einem Fehler ab (“object ‘daten’ not found”). Die Lösung wäre, den Import-Chunk (Chunk 2) vor den Berechnungs-Chunk (Chunk 1) zu verschieben. Quarto erkennt Abhängigkeiten nicht automatisch und führt Chunks weder parallel noch in einer optimierten Reihenfolge aus.
Welche Aussagen zum Visual Editor und Source Editor in RStudio sind korrekt?
Korrekt sind Aussagen 1 und 3. Der Visual Editor zeigt den Markdown-Text formatiert an (WYSIWYG), während der Source Editor die Rohsyntax zeigt — beide Ansichten bearbeiten jedoch dasselbe Dokument (Aussage 2 ist falsch). Der Source Editor ist besonders hilfreich bei der Fehlersuche, weil YAML-Fehler, fehlende Chunk-Grenzen oder falsche Inline-Code-Syntax dort direkt erkennbar sind. Aussage 4 ist falsch: Im Visual Editor können Code-Chunks über den grünen Insert-Button oder das Tastenkürzel Ctrl+Alt+I eingefügt werden.
Welche Aussagen zur reproduzierbaren Ergebnisdokumentation mit Quarto sind korrekt?
Quarto integriert Text, Code und Output in einem Dokument, sodass Änderungen am Code automatisch die Ergebnisse aktualisieren — das ist der Kern reproduzierbarer Berichterstattung. Der Copy-Paste-Workflow ist fehleranfällig, weil Grafiken und Zahlen manuell übertragen und bei Änderungen erneut aktualisiert werden müssen. Falsch ist, dass Quarto nur HTML erzeugen kann — es unterstützt auch PDF, Word und weitere Formate. Ebenso falsch ist, dass Code immer sichtbar sein muss: Mit der Chunk-Option echo: false kann der Code verborgen werden, während die Ergebnisse angezeigt werden.
Sie erstellen einen Analysebericht für eine Auftraggeberin, die keinen R-Code lesen kann, aber die Ergebnisse (Tabellen und Grafiken) sehen möchte. Welche Chunk-Option ist am geeignetsten?
Korrekt ist echo: false. Diese Option verbirgt den R-Code im gerenderten Dokument, sodass nur die Ergebnisse (Tabellen, Grafiken, Zahlen) angezeigt werden. Entscheidend ist: Der Code bleibt im Quelldokument (.qmd) erhalten und wird beim Rendern ausgeführt — Verbergen ist nicht Löschen. echo: true würde den Code anzeigen, was für eine nicht-technische Auftraggeberin ungeeignet ist. Das Löschen des Codes widerspricht dem Prinzip der Reproduzierbarkeit. eval: false würde den Code anzeigen, aber nicht ausführen — es gäbe also keine Ergebnisse im Bericht.
Praktische Aufgabe: Mini-Analysebericht in Quarto
Sie erstellen heute einen kurzen Quarto-Bericht mit Text, Deskriptivstatistik und einem Plot. Szenario: Sie arbeiten in einem Forschungsprojekt, in dem ein Experiment zu Stress und Arbeitsgedächtnisleistung durchgeführt wurde. Der Datensatz df_analyse_NEU.csv ist derselbe wie in Übung 7 und Übung 8.
TipQuarto in RStudio: Die fünf Aufgaben
Die webR-Konsole eignet sich zum Üben des R-Codes. Den eigentlichen Quarto-Bericht erstellen Sie in RStudio:
Dokument erstellen: File → New File → Quarto Document. Titel: „WM-Analyse”, Format: HTML. Speichern Sie die Datei im Projekt-Root. Wechseln Sie zwischen Visual Editor und Source Editor. Schreiben Sie eine Überschrift „Einleitung” und einen kurzen Satz. Rendern Sie das Dokument.
Daten einlesen: Fügen Sie einen Code-Chunk ein mit library(tidyverse), library(here) und daten <- read.csv2(here("daten", "df_analyse_NEU.csv")). Setzen Sie #| message: false, um Paketmeldungen zu unterdrücken. Rendern Sie.
Deskriptive Statistik + Inline-Code: Fügen Sie einen zweiten Chunk ein, der Mittelwert und SD von wm_score_t1 pro Gruppe berechnet. Schreiben Sie unter dem Chunk einen Satz mit Inline-Code: „Der Mittelwert in der KG betrug [Backtick]r round(mean(…), 1)[Backtick] Punkte.” — also Backtick + r + Leerzeichen + R-Ausdruck + Backtick.
Plot einbetten: Fügen Sie einen dritten Chunk mit einem Boxplot von wm_score_t1 nach gruppe ein (Code aus Aufgabe 3 oben). Setzen Sie #| echo: false, sodass nur der Plot im Bericht erscheint.
Rendern und prüfen: Rendern Sie das gesamte Dokument. Checkliste: Erscheint der Mittelwert im Text? Ist der Plot sichtbar? Ist der Code für den Plot verborgen?
NoteWeiterführende Materialien
Quarto Cheatsheet: Übersicht über YAML-Optionen, Chunk-Optionen, Markdown-Syntax und Ausgabeformate.
Introduction to Quarto: Einführung mit Schwerpunkt Visual/Source Editor und Code-Chunks.
Viele psychologische Seminar- und Abschlussarbeiten müssen im APA-Format eingereicht werden. Das Paket apaquarto erweitert Quarto um eine APA-7-Vorlage. Diese formatiert Titelseite, Literaturverzeichnis und Statistik-Ausgaben automatisch.
Hinweis: Dies ist kein Prüfungsstoff, sondern eine Anregung für künftige Arbeiten.