Block-Konstrukte

Block-Erweiterungen über den Markdown-Kern hinaus. Jedes Kapitel zeigt die Syntax als Code-Block und direkt darunter das gerenderte Ergebnis; in der geteilten Ansicht stehen beide nebeneinander.

Callouts

Hinweis-Boxen: > [!typ] als erste Zeile eines Blockquote-Blocks, optional mit eigenem Titel. Zehn Typen mit eigenem Icon und Akzentfarbe: note, info, tip, success, question, warning, failure, danger, example, quote. Unbekannte Typen meldet der Markdown-Linter.

> [!tip] Eigener Titel
> Inhalt der Box, normales Markdown erlaubt.

Ein + oder - hinter dem Typ macht den Callout klappbar: + startet geöffnet, - eingeklappt — das Auf- und Zuklappen funktioniert auch im Handbuch.

> [!note]- Eingeklappt gestartet
> Erst nach Klick auf den Titel sichtbar.

Custom Containers

Container-Blöcke zwischen ::: typ und :::. Die zehn Callout-Typen erscheinen in Callout-Optik, unbekannte Namen als neutrale Box mit dem Namen als Titel.

::: warning
Inhalt in Callout-Optik.
:::

Mehrspalten-Block

Ein Container ::: columns <n> setzt den eingeschlossenen Inhalt mehrspaltig; gültig sind 2 bis 5 Spalten. Der Text fließt automatisch und ausgeglichen über die Spalten; eine Zeile +++ erzwingt den Wechsel in die nächste Spalte. Ungültige Spaltenzahlen (fehlend, 1, mehr als 5, nicht numerisch) fallen auf die neutrale Container-Box zurück; außerhalb eines Mehrspalten-Blocks ist +++ wirkungslos.

::: columns 2
Erste Spalte mit fließendem Text.

+++

Ab hier die zweite Spalte.
:::

Breite Inhalte (Tabellen, Diagramme, lange Code-Zeilen) können eine Spalte sprengen; bei sehr kurzen Blöcken kann der automatische Ausgleich ungleich wirken. Im Live-Modus erscheint der Block in neutraler Container-Optik mit sichtbaren Marker-Zeilen; der mehrspaltige Satz gilt für die gerenderte Ansicht und den PDF-Export.

Definitionslisten

Begriff auf einer Zeile, Definition darunter mit : eingeleitet; auch ~ ist als Marker erlaubt. Mehrere Definitionen pro Begriff sind möglich.

Cutover
: Umstellung eines Systems auf den Produktivbetrieb.

Rollback
: Rückkehr zum Stand vor der Umstellung.

Cutover

Umstellung eines Systems auf den Produktivbetrieb.

Rollback

Rückkehr zum Stand vor der Umstellung.

Line Blocks

Zeilen, die mit | beginnen, behalten Zeilenumbrüche und führende Leerzeichen — gedacht für Adressen und Gedichte.

| Stumm-Consulting GmbH
|   4410 Liestal
|   Schweiz

Fußnoten

Drei Formen: Verweis [^id] im Fließtext mit Definition [^id]: Text (üblicherweise am Datei-Ende) sowie die Inline-Form ^[Direkt-Text] ohne separate Definition. Im Render erscheint eine hochgestellte Zahl; die Definitionen sammeln sich am Seitenende mit Rücksprung-Pfeilen.

Eine Aussage mit Beleg[^1] und eine mit Inline-Fußnote^[Direkt notiert].

[^1]: Die Definition steht am Datei-Ende.

Eine Aussage mit Beleg^[1] und eine mit Inline-Fußnote^[2].