Callouts

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

Grundsyntax

> [!note] Achtung
> Dies ist ein Note-Callout.

Achtung

Dies ist ein Note-Callout.

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

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 in derselben Zeile wie die Typ-Markierung. Ohne Titel verwendet der Callout eine Standardüberschrift basierend auf dem Typ.

Einklappbare Callouts

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

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

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

Zum Aufklappen anklicken

Versteckter Inhalt. Klicke auf den Titel oben, um ihn aufzuklappen.

Klicke auf den Titel, um umzuschalten. Gut geeignet für:

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

Alle Callout-Typen

Eduskript liefert 41 Callout-Typen — 15 Basistypen plus Aliasse für gängige alternative Namen:

Basistypen

Aliasse

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

Mehrabsätzige Inhalte

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

> [!note] Titel hier
> Erster Absatz.
>
> Zweiter Absatz.
>
> - Listenpunkt
> - Ein weiterer Punkt
>
> Dritter Absatz mit `inline code` und einem [Link](https://example.com).

Titel hier

Erster Absatz.

Zweiter Absatz.

• Listenpunkt
• Ein weiterer Punkt

Mathe, Codeblöcke, Listen und sogar verschachtelte Callouts funktionieren alle 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; stark verschachtelte Callouts werden schwer lesbar.

Praktische Muster

Versteckte Hinweise

> [!tip]- Nicht weiter?
> Denk zuerst an die Basisfälle.

> [!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, um ihn aufzudecken.

Lernziele am Anfang

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

Vorhersage-dann-Verifikation-Übungen

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

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

Ein Codeblock (gerade gezeigt), dann ein ausführbarer Editor (eingeklappt) zur Verifikation.

Callouts Spickzettel