Callouts

Callouts sind farbige, umrahmte Boxen, die den Blick auf bestimmte Inhalte lenken — Warnungen, Tipps, Lernziele, Beispiele, versteckte Hinweise. Sie bestehen aus gewöhnlichen Markdown-Blockquotes mit einer Typ-Markierung.

Grundsyntax

> [!note] Aufgepasst
> Das ist ein Note-Callout.

Aufgepasst

Das ist ein Note-Callout.

Die erste Zeile nach [!type] ist der Titel. Lässt du ihn weg, verwendet der Callout den Typnamen als Standardüberschrift.

Mit eigenem Titel

> [!warning] Vorsicht
> Diese Aktion kann nicht rückgängig gemacht werden.

Vorsicht

Diese Aktion kann nicht rückgängig gemacht werden.

Der Titel steht auf derselben Zeile wie die Typ-Markierung. Ohne Titel verwendet der Callout eine Standardüberschrift basierend auf dem Typ.

Einklappbare Callouts

Füge - hinzu für standardmässig eingeklappt, + für ausgeklappt:

> [!tip]- Zum Ausklappen klicken
> Versteckter Inhalt. Nützlich für Hinweise, Lösungen, optionale Vertiefungen.

> [!tip]+ Standardmässig ausgeklappt
> Sichtbarer Inhalt, aber mit Einklapp-Button, damit Schüler ihn verbergen können.

Zum Ausklappen klicken

Versteckter Inhalt. Klicke auf den Titel oben zum Ausklappen.

Klicke auf den Titel zum Umschalten. Ideal für:

• Hinweise und Lösungen («Klicke für die Antwort»)
• Optionale Vertiefungen, die nicht jeder Schüler braucht
• Lange Beispiele, die die Seite überladen, wenn sie immer ausgeklappt sind

Alle Callout-Typen

Eduskript bringt 41 Callout-Typen mit — 15 Basistypen plus Aliase für gängige alternative Namen:

Basistypen

Aliase

Verwende, was sich natürlich anfühlt — lernziele ist dasselbe wie success ist dasselbe wie done. Alle rendern denselben Callout.

Mehrere Absätze

Alles nach der ersten Zeile ist Callout-Inhalt. Fahre mit > auf jeder Zeile fort:

> [!note] Titel hier
> Erster Absatz.
>
> Zweiter Absatz.
>
> - Listenpunkt
> - Noch ein Punkt
>
> Dritter Absatz mit `Inline-Code` und einem [Link](https://example.com).

Titel hier

Erster Absatz.

Zweiter Absatz.

• Listenpunkt
• Noch ein Punkt

Mathematik, Code-Blöcke, Listen und sogar verschachtelte Callouts funktionieren darin.

Callouts in Callouts

> [!example] Äusserer Callout
> Eine Erklärung.
>
> > [!warning] Verschachtelt
> > Eine Warnung innerhalb des Beispiels.

Nützlich für Beispiele mit Vorbehalten — aber sparsam einsetzen; tief verschachtelte Callouts werden schwer lesbar.

Praktische Muster

Versteckte Hinweise

> [!tip]- Kommst du nicht weiter?
> Denke zuerst über die Basisfälle nach.

> [!solution]- Lösung
> ```python
> def factorial(n):
>     return 1 if n <= 1 else n * factorial(n - 1)
> ```

Das - hält ihn eingeklappt; Schüler klicken zum Aufdecken.

Lernziele am Anfang

> [!success] Lernziele
> Am Ende dieser Seite kannst du:
> - Eine Funktion mit Parametern definieren
> - Einen Wert zurückgeben
> - Den Unterschied zwischen Parameter und Argument erkennen

Vorhersagen-dann-prüfen-Übungen

> [!question] Vorhersage
> Was gibt dieser Code aus?
> ```python
> for i in range(3, 0, -1):
>     print(i)
> ```

> [!solution]- Prüfen
> ```python editor
> for i in range(3, 0, -1):
>     print(i)
> ```

Ein Code-Block (nur angezeigt), dann ein ausführbarer Editor (eingeklappt) zur Überprüfung.

Callouts-Spickzettel