AsciiDoc Element Showcase

Dies ist ein Absatz mit der Klasse drop-cap und einer expliziten ID. Der erste Buchstabe sollte gross und dekorativ dargestellt werden — genau wie im Governance-Artikel. Dieser Absatz testet das paragraph.njk-Template mit Rolle und ID.

Ein normaler Absatz ohne besondere Attribute. Er enthaelt fetten Text, kursiven Text und monospaced Text. Ausserdem einen Link zu einer externen Seite.

Ein weiterer Absatz, um sicherzustellen, dass mehrere aufeinanderfolgende Absaetze korrekt gerendert werden, ohne unerwuenschte Wrapper oder zusaetzliche Abstande.

Inline-Formatierung

Dieser Abschnitt testet alle Inline-Formatierungen:

• Fett (strong): Dies ist fett gedruckter Text.
• Kursiv (emphasis): Dies ist kursiver Text.
• Monospaced: Dies ist monospaced/code Text.
• Fett und kursiv: Dies ist fett und kursiv zugleich.
• Hochgestellt: H₂O (Subscript) und E=mc² (Superscript).
• Durchgestrichen: dieser Text ist durchgestrichen.

Ueberschriften-Hierarchie

Dieser Abschnitt testet die Ueberschriften-Hierarchie. Die <h2> oben hat eine explizite ID (section-3), die h3/h4 darunter sollten keine auto-generierten IDs haben.

Ueberschrift Ebene 3 (h3)

Text unter einer h3-Ueberschrift.

Ueberschrift Ebene 4 (h4)

Text unter einer h4-Ueberschrift. Diese Ebene wird seltener benutzt, muss aber trotzdem korrekt rendern.

Ueberschrift Ebene 5 (h5)

Text unter einer h5-Ueberschrift. Wird fuer feingliedrige Untergliederungen verwendet.

Ueberschrift Ebene 6 (h6)

Text unter einer h6-Ueberschrift. Die kleinste Ueberschriftenebene — uppercase mit Letter-Spacing, um sie visuell von normalem Body-Text abzuheben.

Listen

Geordnete Liste (Ordered List)

1. Erster Punkt: Mit fettem Label und normalem Text dahinter.
2. Zweiter Punkt: Noch ein Eintrag mit kursivem Text.
3. Dritter Punkt: Ein Eintrag mit code und einem Link.
4. Vierter Punkt ohne fettes Label — nur normaler Text.

Ungeordnete Liste (Unordered List)

• Einfacher Listenpunkt
• Listenpunkt mit fetter Hervorhebung
• Listenpunkt mit kursiver Hervorhebung
• Listenpunkt mit monospaced Text

Verschachtelte Liste

• Hauptpunkt 1
  • Unterpunkt 1a
  • Unterpunkt 1b
• Hauptpunkt 2
  • Unterpunkt 2a
    • Unter-Unterpunkt 2a-i
  • Unterpunkt 2b

Admonitions (Info-Boxen)

TIP mit Custom-Titel

TIP mit Default-Titel

WARNING mit Custom-Titel

WARNING mit Default-Titel

NOTE

IMPORTANT

Code-Bloecke

YAML mit Syntax-Highlighting

JSON Code-Block

{
  "status": "success",
  "data": {
    "apis": 1247,
    "compliant": 1189,
    "score": 95.3
  }
}

Code-Block ohne Sprache

Dies ist ein Code-Block ohne Sprachangabe.
Er sollte als plain text gerendert werden.

Zitate (Pull-Quotes)

Zitat mit Attribution und Citetitle

Zitat nur mit Attribution

Zitat ohne Attribution

Bilder

Platzhalter-Bild (mit .placeholder Rolle)

Zweites Platzhalter-Bild

Tabellen

Einfache Tabelle

Tabelle ohne Header

Tabelle mit Footer

CSV-Tabelle (Shorthand)

DSV-Tabelle (Doppelpunkt-Trenner)

Custom Macros

stat-callout Block-Macro

article Cross-Reference Inline-Macro

Einfacher Link: API Definition Artikel.

Link mit Anchor: Swagger Grundlagen.

Link mit Title-Attribut: API Definition Guide.

Link mit Anchor + Title: Swagger im Detail.

Unbekannte pageId (Error-Log testen): Dieser Link existiert nicht.

Callouts (Code-Annotationen)

Code-Callouts erlauben nummerierte Annotationen direkt im Quellcode, die unter dem Code-Block erklaert werden.

JavaScript mit Callouts

import express from 'express'; // <1>

const app = express(); // <2>
app.use(express.json()); // <3>

app.get('/api/health', (req, res) => { // <4>
  res.json({ status: 'ok', timestamp: Date.now() });
});

app.listen(3000, () => { // <5>
  console.log('Server laeuft auf Port 3000');
});

YAML mit Callouts

Fussnoten

Fussnoten eignen sich fuer Quellenangaben und ergaenzende Informationen, die den Lesefluss nicht stoeren sollen.

API Governance ist ein systematischer Ansatz zur Steuerung von APIs.^[1] Die fuenf Saeulen umfassen Design, Security, Lifecycle, Monitoring und Documentation.^[2]

Eine benannte Fussnote kann mehrfach referenziert werden.^[3] Spaeter im Text kann man die gleiche Quelle erneut zitieren.^[3]

Zeilenumbrueche

Einzelne Zeilenumbrueche mit

Zeile eins mit explizitem Umbruch,
Zeile zwei folgt direkt darunter,
und Zeile drei schliesst den Absatz.

Block-Attribut hardbreaks

Dr. Lukas Schreiber
API Portal GmbH
Musterstrasse 42
10115 Berlin
Deutschland