Skip to main content

Details-Tag

Das Details-Tag fasst Inhalt in einem aufklappbaren Abschnitt zusammen – wie die aufklappbaren Bereiche in GitHub. Der Abschnitt wird im Dokument als natives Aufklapp-Element gerendert und funktioniert ohne JavaScript.

Syntax

Öffnungs- und Schluss-Tag stehen jeweils in einer eigenen Zeile. Die einzeilige Schreibweise ({% details %}Text{% /details %}) wird beim Speichern abgelehnt, weil Markdoc den Abschnitt dann innerhalb eines Absatzes einfügt.

Parameter

Beispiele

Aufgeklappter Abschnitt mit Berechnung:
Verschachtelte Abschnitte:
Ohne Beschriftung:

Funktionsweise

  1. Der Abschnitt wird als aufklappbares Element gerendert; die Beschriftung ist anklickbar
  2. Mit open=true ist der Abschnitt im Dokument von Anfang an geöffnet
  3. Variablen innerhalb eines zugeklappten Abschnitts erscheinen trotzdem als Eingabefelder
  4. Abschnitte können beliebig ineinander verschachtelt werden
  5. Beim Kopieren eines Dokuments wird der Inhalt zugeklappter Abschnitte mit übernommen

Best Practices

  • ✅ Verwenden Sie aussagekräftige Beschriftungen, damit klar ist, was im Abschnitt steht
  • ✅ Klappen Sie Zusatzinformationen zu, die den Textfluss sonst unterbrechen
  • ✅ Legen Sie Abschnitte, die im Ausdruck erscheinen müssen, mit open=true an
  • ❌ Verstecken Sie keine medizinisch notwendigen Angaben in zugeklappten Abschnitten