From dcdb6ee6373538458917a8596e8688f01e2967a0 Mon Sep 17 00:00:00 2001
From: Sebastian Frank <sebastian@webmakers.de>
Date: Sat, 17 Oct 2026 13:54:52 +0000
Subject: [PATCH] Darstellung: Inline-Code-Chips fuer Dark Mode, 58 Seiten auf
 .mdx (Komponenten rendern jetzt)

Befund 1 (Nutzer): Inline-Code war im Dark Mode kaum lesbar.
- src/styles/custom.css: eigene Chip-Farben (--tibi-inline-*), Rahmen, nowrap in der ersten Tabellenspalte
- gemessen: Text/Chip 10,2:1 dunkel, 12,4:1 hell

Befund 2 (beim Nachmessen gefunden): 58 Seiten waren .md - Starlight-Komponenten wurden NICHT gerendert
(rohe <Aside>/<Steps>-Tags, import-Zeile als sichtbarer Text auf 57 Seiten).
- alle 58 Seiten auf .mdx umgestellt und MDX-konform gemacht (Imports, Block-Tags in eigenen Zeilen,
  HTML-Kommentare -> {/* */}, geschweifte Klammern escaped)
- nachher: 428 Asides, 87 Steps, 158 Tab-Gruppen gerendert, 0 geleakte Imports
- fehlender Import in reference/hooks-daten ergaenzt

Regressionsschutz: audit-docs.mjs prueft jetzt Komponente-ohne-Import, .md-mit-Komponente,
geleakte Imports und rohe Tags im gebauten dist/. AGENTS.md 3 dokumentiert die .mdx-Regel.

Nebenfund: de.json mit ASCII-Umschreibungen -> Issue tibi-admin-nova #6
Build: 71 Seiten gruen, Audit 7 legitime Platzhalter-Marker
---
 AGENTS.md                                     |   9 ++
 plans/audit-report.json                       | 100 +++++++++---------
 plans/doku-ausbau.md                          |   3 +-
 plans/offene-issues.md                        |   4 +-
 scripts/audit-docs.mjs                        |  38 ++++++-
 .../docs/admin/{aktionen.md => aktionen.mdx}  |  15 ++-
 ...sichten-listen.md => ansichten-listen.mdx} |   0
 ...benutzer-rechte.md => benutzer-rechte.mdx} |  10 +-
 .../admin/{customizing.md => customizing.mdx} |   5 +-
 ...eintrags-editor.md => eintrags-editor.mdx} |   0
 .../docs/admin/{exporte.md => exporte.mdx}    |   0
 .../{ki-funktionen.md => ki-funktionen.mdx}   |  17 +--
 .../docs/admin/{konzept.md => konzept.mdx}    |   0
 .../docs/admin/{medien.md => medien.mdx}      |   0
 .../docs/admin/{setup.md => setup.mdx}        |   5 +-
 .../anwender/{aktionen.md => aktionen.mdx}    |   4 +-
 .../anwender/{anmelden.md => anmelden.mdx}    |   2 +-
 ...up-einspielen.md => backup-einspielen.mdx} |  10 +-
 .../{benutzer-teams.md => benutzer-teams.mdx} |   0
 ...g-bearbeiten.md => eintrag-bearbeiten.mdx} |   0
 .../{exportieren.md => exportieren.mdx}       |   0
 .../docs/anwender/{hilfe.md => hilfe.mdx}     |   0
 .../anwender/{ki-nutzen.md => ki-nutzen.mdx}  |   0
 ...en-filtern.md => lesen-suchen-filtern.mdx} |   2 +-
 ...enbearbeitung.md => massenbearbeitung.mdx} |  10 +-
 .../docs/anwender/{medien.md => medien.mdx}   |   2 +-
 .../{orientierung.md => orientierung.mdx}     |   0
 .../{seiten-bauen.md => seiten-bauen.mdx}     |   0
 .../docs/anwender/{sichern.md => sichern.mdx} |   0
 ...mbinationen.md => tastenkombinationen.mdx} |   0
 ...tellen.md => verlauf-wiederherstellen.mdx} |   0
 .../{neues-projekt.md => neues-projekt.mdx}   |   0
 .../{schnellstart.md => schnellstart.mdx}     |   0
 .../{was-ist-tibi.md => was-ist-tibi.mdx}     |   0
 .../{abfragen-lesen.md => abfragen-lesen.mdx} |   0
 .../{audit-backup.md => audit-backup.mdx}     |  15 ++-
 .../{dateien-bilder.md => dateien-bilder.mdx} |   0
 .../docs/projekt/{deploy.md => deploy.mdx}    |   0
 .../{feld-rechte.md => feld-rechte.mdx}       |   0
 .../{felder-widgets.md => felder-widgets.mdx} |   0
 ...hooks-schreiben.md => hooks-schreiben.mdx} |   0
 .../{jobs-actions.md => jobs-actions.mdx}     |  10 +-
 .../projekt/{llm-nutzen.md => llm-nutzen.mdx} |   0
 .../projekt/{mcp-nutzen.md => mcp-nutzen.mdx} |   0
 ...navigation-i18n.md => navigation-i18n.mdx} |   0
 ...pagebuilder-dev.md => pagebuilder-dev.mdx} |   2 +-
 .../{rechte-tokens.md => rechte-tokens.mdx}   |   0
 ...ngen-anlegen.md => sammlungen-anlegen.mdx} |   0
 .../{ssr-website.md => ssr-website.mdx}       |  10 +-
 .../docs/projekt/{suche.md => suche.mdx}      |   0
 .../docs/projekt/{tests.md => tests.mdx}      |   0
 .../{fehlercodes.md => fehlercodes.mdx}       |   0
 .../{hook-kontexte.md => hook-kontexte.mdx}   |   0
 .../{hooks-daten.md => hooks-daten.mdx}       |   2 +
 .../{rest-system.md => rest-system.mdx}       |  10 +-
 .../reference/{schemas.md => schemas.mdx}     |   0
 ...urzbefehle.md => tastatur-kurzbefehle.mdx} |   0
 .../{token-koepfe.md => token-koepfe.mdx}     |   4 +-
 .../docs/server/{betrieb.md => betrieb.mdx}   |  16 ++-
 .../{konfiguration.md => konfiguration.mdx}   |  16 ++-
 .../{schnittstellen.md => schnittstellen.mdx} |   0
 .../server/{sicherheit.md => sicherheit.mdx}  |   0
 .../server/{uebersicht.md => uebersicht.mdx}  |   0
 src/styles/custom.css                         |  29 +++++
 64 files changed, 246 insertions(+), 104 deletions(-)
 rename src/content/docs/admin/{aktionen.md => aktionen.mdx} (91%)
 rename src/content/docs/admin/{ansichten-listen.md => ansichten-listen.mdx} (100%)
 rename src/content/docs/admin/{benutzer-rechte.md => benutzer-rechte.mdx} (96%)
 rename src/content/docs/admin/{customizing.md => customizing.mdx} (95%)
 rename src/content/docs/admin/{eintrags-editor.md => eintrags-editor.mdx} (100%)
 rename src/content/docs/admin/{exporte.md => exporte.mdx} (100%)
 rename src/content/docs/admin/{ki-funktionen.md => ki-funktionen.mdx} (89%)
 rename src/content/docs/admin/{konzept.md => konzept.mdx} (100%)
 rename src/content/docs/admin/{medien.md => medien.mdx} (100%)
 rename src/content/docs/admin/{setup.md => setup.mdx} (97%)
 rename src/content/docs/anwender/{aktionen.md => aktionen.mdx} (91%)
 rename src/content/docs/anwender/{anmelden.md => anmelden.mdx} (94%)
 rename src/content/docs/anwender/{backup-einspielen.md => backup-einspielen.mdx} (81%)
 rename src/content/docs/anwender/{benutzer-teams.md => benutzer-teams.mdx} (100%)
 rename src/content/docs/anwender/{eintrag-bearbeiten.md => eintrag-bearbeiten.mdx} (100%)
 rename src/content/docs/anwender/{exportieren.md => exportieren.mdx} (100%)
 rename src/content/docs/anwender/{hilfe.md => hilfe.mdx} (100%)
 rename src/content/docs/anwender/{ki-nutzen.md => ki-nutzen.mdx} (100%)
 rename src/content/docs/anwender/{lesen-suchen-filtern.md => lesen-suchen-filtern.mdx} (96%)
 rename src/content/docs/anwender/{massenbearbeitung.md => massenbearbeitung.mdx} (84%)
 rename src/content/docs/anwender/{medien.md => medien.mdx} (93%)
 rename src/content/docs/anwender/{orientierung.md => orientierung.mdx} (100%)
 rename src/content/docs/anwender/{seiten-bauen.md => seiten-bauen.mdx} (100%)
 rename src/content/docs/anwender/{sichern.md => sichern.mdx} (100%)
 rename src/content/docs/anwender/{tastenkombinationen.md => tastenkombinationen.mdx} (100%)
 rename src/content/docs/anwender/{verlauf-wiederherstellen.md => verlauf-wiederherstellen.mdx} (100%)
 rename src/content/docs/einstieg/{neues-projekt.md => neues-projekt.mdx} (100%)
 rename src/content/docs/einstieg/{schnellstart.md => schnellstart.mdx} (100%)
 rename src/content/docs/einstieg/{was-ist-tibi.md => was-ist-tibi.mdx} (100%)
 rename src/content/docs/projekt/{abfragen-lesen.md => abfragen-lesen.mdx} (100%)
 rename src/content/docs/projekt/{audit-backup.md => audit-backup.mdx} (98%)
 rename src/content/docs/projekt/{dateien-bilder.md => dateien-bilder.mdx} (100%)
 rename src/content/docs/projekt/{deploy.md => deploy.mdx} (100%)
 rename src/content/docs/projekt/{feld-rechte.md => feld-rechte.mdx} (100%)
 rename src/content/docs/projekt/{felder-widgets.md => felder-widgets.mdx} (100%)
 rename src/content/docs/projekt/{hooks-schreiben.md => hooks-schreiben.mdx} (100%)
 rename src/content/docs/projekt/{jobs-actions.md => jobs-actions.mdx} (96%)
 rename src/content/docs/projekt/{llm-nutzen.md => llm-nutzen.mdx} (100%)
 rename src/content/docs/projekt/{mcp-nutzen.md => mcp-nutzen.mdx} (100%)
 rename src/content/docs/projekt/{navigation-i18n.md => navigation-i18n.mdx} (100%)
 rename src/content/docs/projekt/{pagebuilder-dev.md => pagebuilder-dev.mdx} (98%)
 rename src/content/docs/projekt/{rechte-tokens.md => rechte-tokens.mdx} (100%)
 rename src/content/docs/projekt/{sammlungen-anlegen.md => sammlungen-anlegen.mdx} (100%)
 rename src/content/docs/projekt/{ssr-website.md => ssr-website.mdx} (96%)
 rename src/content/docs/projekt/{suche.md => suche.mdx} (100%)
 rename src/content/docs/projekt/{tests.md => tests.mdx} (100%)
 rename src/content/docs/reference/{fehlercodes.md => fehlercodes.mdx} (100%)
 rename src/content/docs/reference/{hook-kontexte.md => hook-kontexte.mdx} (100%)
 rename src/content/docs/reference/{hooks-daten.md => hooks-daten.mdx} (99%)
 rename src/content/docs/reference/{rest-system.md => rest-system.mdx} (90%)
 rename src/content/docs/reference/{schemas.md => schemas.mdx} (100%)
 rename src/content/docs/reference/{tastatur-kurzbefehle.md => tastatur-kurzbefehle.mdx} (100%)
 rename src/content/docs/reference/{token-koepfe.md => token-koepfe.mdx} (99%)
 rename src/content/docs/server/{betrieb.md => betrieb.mdx} (81%)
 rename src/content/docs/server/{konfiguration.md => konfiguration.mdx} (73%)
 rename src/content/docs/server/{schnittstellen.md => schnittstellen.mdx} (100%)
 rename src/content/docs/server/{sicherheit.md => sicherheit.mdx} (100%)
 rename src/content/docs/server/{uebersicht.md => uebersicht.mdx} (100%)

diff --git a/AGENTS.md b/AGENTS.md
index 30bc8e6..2ee6d9c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -38,6 +38,12 @@ Jede Seite nennt ihre Quelle-der-Wahrheit (Code zuerst), hat einen Stempel am En
 ## 3. Neue Seite anlegen
 
 - Datei `src/content/docs/<bereich>/<slug>.md` mit Frontmatter `title` + `description`.
+- **Sobald die Seite eine Starlight-Komponente nutzt (`<Aside>`, `<Steps>`, `<Tabs>`, `<Card>`, `<LinkCard>`, `<Badge>`, `<FileTree>`), muss die Datei `.mdx` heißen.** In reinem Markdown (`.md`) werden Komponenten-Tags **nicht** gerendert: sie landen als unbekannte HTML-Tags im Ergebnis, und die `import`-Zeile erscheint als sichtbarer Text auf der Seite (`scripts/audit-docs.mjs` prüft das gegen `dist/`).
+- MDX-Regeln, die die Konvertierung erfüllen muss:
+  - `import …` steht als erste Zeile **vor** dem Inhalt (nach dem Frontmatter).
+  - Block-Komponenten: öffnendes Tag in eigener Zeile, Inhalt, schließendes Tag in eigener Zeile (nicht `Text</Aside>` in einer Zeile).
+  - Kommentar-Hinweise als `{/* … */}` schreiben, **nicht** als `<!-- … -->`.
+  - Geschweifte Klammern im Fließtext escapen (`\{count\}`) — in Code-Spans und Codeblöcken nicht nötig.
 - Sidebar: jede Gruppe explizit in `astro.config.mjs` eintragen (beim Neuaufbau pro Bereich ergänzen; `autogenerate` erst nutzen, sobald der Ordner gepflegt befüllt ist).
 - Bilder nach `src/assets/`, max. 200 KB, deutsche Alt-Texte.
 - Screenshots: nur Mock-Projekt `corporate` (nie `t1`), Ablauf unter `plans/t-shots-arbeitsauftrag.md`.
@@ -57,6 +63,9 @@ npm run build                 # muss grün durchlaufen (prüft interne Links NIC
 - `scripts/audit-docs.mjs` meldet tote Links/Anker, kaputte Tabellen, fehlende Alt-Texte und offene
   Platzhalter-Marker. Ergebnis **muss** „0 tote Links, 0 kaputte Tabellen" sein; verbleibende Marker
   sind zu begründen.
+- Zusätzlich prüft das Skript das **gebaute** `dist/`: geleakte `import`-Zeilen, rohe `<Aside>`/`<Steps>`-Tags
+  und fehlende Komponenten-Klassen. Erst `npm run build`, dann `node scripts/audit-docs.mjs` — so fällt auf,
+  wenn eine Seite als `.md` statt `.mdx` angelegt wurde.
 - `scripts/gen-schema-matrix.mjs` und `reference/schema-properties.md` sind ein Paar: Seite nie von Hand
   editieren, Schemas nie in der Doku nachpflegen — nur `npm run gen:schemas` laufen lassen.
 - `scripts/sync-server-docs.mjs` ist **stillgelegt** (der Server-Sync erzeugte verwaiste Seiten ohne
diff --git a/plans/audit-report.json b/plans/audit-report.json
index 39960ad..beabac1 100644
--- a/plans/audit-report.json
+++ b/plans/audit-report.json
@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-10-17T13:19:19.983Z",
+  "generatedAt": "2026-10-17T13:54:38.079Z",
   "stats": {
     "files": 70,
     "byDir": {
@@ -27,60 +27,60 @@
     "emptyFenceLang": 0,
     "proseWalls": [],
     "asciiUmlauts": [
-      "src/content/docs/admin/aktionen.md",
-      "src/content/docs/anwender/aktionen.md",
-      "src/content/docs/projekt/felder-widgets.md",
-      "src/content/docs/projekt/mcp-nutzen.md",
-      "src/content/docs/projekt/navigation-i18n.md",
-      "src/content/docs/projekt/ssr-website.md",
+      "src/content/docs/admin/aktionen.mdx",
+      "src/content/docs/anwender/aktionen.mdx",
+      "src/content/docs/projekt/felder-widgets.mdx",
+      "src/content/docs/projekt/mcp-nutzen.mdx",
+      "src/content/docs/projekt/navigation-i18n.mdx",
+      "src/content/docs/projekt/ssr-website.mdx",
       "src/content/docs/reference/schema-properties.md"
     ],
     "hollowMarkers": [
-      "src/content/docs/admin/exporte.md:37 Platzhalter",
-      "src/content/docs/anwender/seiten-bauen.md:45 Platzhalter",
-      "src/content/docs/einstieg/neues-projekt.md:26 Platzhalter",
-      "src/content/docs/einstieg/schnellstart.md:48 noch nicht",
-      "src/content/docs/einstieg/schnellstart.md:21 Platzhalter",
-      "src/content/docs/einstieg/was-ist-tibi.md:11 Platzhalter",
-      "src/content/docs/projekt/deploy.md:26 Platzhalter"
+      "src/content/docs/admin/exporte.mdx:37 Platzhalter",
+      "src/content/docs/anwender/seiten-bauen.mdx:45 Platzhalter",
+      "src/content/docs/einstieg/neues-projekt.mdx:26 Platzhalter",
+      "src/content/docs/einstieg/schnellstart.mdx:48 noch nicht",
+      "src/content/docs/einstieg/schnellstart.mdx:21 Platzhalter",
+      "src/content/docs/einstieg/was-ist-tibi.mdx:11 Platzhalter",
+      "src/content/docs/projekt/deploy.mdx:26 Platzhalter"
     ],
     "t1Refs": [
       "src/content/docs/adr/0003-selbstlaeufer.md"
     ],
     "tibiAdminRefs": [
-      "src/content/docs/admin/aktionen.md (2×)",
-      "src/content/docs/admin/ansichten-listen.md (2×)",
-      "src/content/docs/admin/benutzer-rechte.md (7×)",
-      "src/content/docs/admin/customizing.md (2×)",
-      "src/content/docs/admin/eintrags-editor.md (2×)",
-      "src/content/docs/admin/exporte.md (2×)",
-      "src/content/docs/admin/ki-funktionen.md (3×)",
-      "src/content/docs/admin/konzept.md (4×)",
-      "src/content/docs/admin/medien.md (2×)",
-      "src/content/docs/admin/setup.md (5×)",
+      "src/content/docs/admin/aktionen.mdx (2×)",
+      "src/content/docs/admin/ansichten-listen.mdx (2×)",
+      "src/content/docs/admin/benutzer-rechte.mdx (7×)",
+      "src/content/docs/admin/customizing.mdx (2×)",
+      "src/content/docs/admin/eintrags-editor.mdx (2×)",
+      "src/content/docs/admin/exporte.mdx (2×)",
+      "src/content/docs/admin/ki-funktionen.mdx (3×)",
+      "src/content/docs/admin/konzept.mdx (4×)",
+      "src/content/docs/admin/medien.mdx (2×)",
+      "src/content/docs/admin/setup.mdx (5×)",
       "src/content/docs/adr/0001-starlight.md (1×)",
       "src/content/docs/adr/0002-code-schlaegt-doku.md (2×)",
       "src/content/docs/adr/0003-selbstlaeufer.md (1×)",
-      "src/content/docs/anwender/anmelden.md (5×)",
-      "src/content/docs/anwender/benutzer-teams.md (1×)",
-      "src/content/docs/anwender/exportieren.md (3×)",
-      "src/content/docs/anwender/ki-nutzen.md (1×)",
-      "src/content/docs/anwender/lesen-suchen-filtern.md (1×)",
-      "src/content/docs/anwender/medien.md (1×)",
-      "src/content/docs/anwender/orientierung.md (2×)",
-      "src/content/docs/anwender/seiten-bauen.md (1×)",
-      "src/content/docs/anwender/sichern.md (1×)",
+      "src/content/docs/anwender/anmelden.mdx (5×)",
+      "src/content/docs/anwender/benutzer-teams.mdx (1×)",
+      "src/content/docs/anwender/exportieren.mdx (3×)",
+      "src/content/docs/anwender/ki-nutzen.mdx (1×)",
+      "src/content/docs/anwender/lesen-suchen-filtern.mdx (1×)",
+      "src/content/docs/anwender/medien.mdx (1×)",
+      "src/content/docs/anwender/orientierung.mdx (2×)",
+      "src/content/docs/anwender/seiten-bauen.mdx (1×)",
+      "src/content/docs/anwender/sichern.mdx (1×)",
       "src/content/docs/einstieg/begriffe.md (4×)",
-      "src/content/docs/einstieg/neues-projekt.md (1×)",
-      "src/content/docs/einstieg/schnellstart.md (1×)",
-      "src/content/docs/einstieg/was-ist-tibi.md (3×)",
-      "src/content/docs/projekt/audit-backup.md (2×)",
-      "src/content/docs/projekt/jobs-actions.md (1×)",
-      "src/content/docs/projekt/navigation-i18n.md (1×)",
-      "src/content/docs/projekt/pagebuilder-dev.md (1×)",
-      "src/content/docs/projekt/sammlungen-anlegen.md (1×)",
-      "src/content/docs/projekt/suche.md (2×)",
-      "src/content/docs/reference/tastatur-kurzbefehle.md (2×)"
+      "src/content/docs/einstieg/neues-projekt.mdx (1×)",
+      "src/content/docs/einstieg/schnellstart.mdx (1×)",
+      "src/content/docs/einstieg/was-ist-tibi.mdx (3×)",
+      "src/content/docs/projekt/audit-backup.mdx (2×)",
+      "src/content/docs/projekt/jobs-actions.mdx (1×)",
+      "src/content/docs/projekt/navigation-i18n.mdx (1×)",
+      "src/content/docs/projekt/pagebuilder-dev.mdx (1×)",
+      "src/content/docs/projekt/sammlungen-anlegen.mdx (1×)",
+      "src/content/docs/projekt/suche.mdx (2×)",
+      "src/content/docs/reference/tastatur-kurzbefehle.mdx (2×)"
     ],
     "fm_hero": 1,
     "fm_template": 1
@@ -92,43 +92,43 @@
   },
   "findings": [
     {
-      "file": "src/content/docs/admin/exporte.md",
+      "file": "src/content/docs/admin/exporte.mdx",
       "kind": "hollow",
       "msg": "Marker \"Platzhalter\": Stehen im Export-Dialog eigene Reiter **vor** dem Standard-Tab, hat das Projekt fertige Berichte in `collectio",
       "line": 37
     },
     {
-      "file": "src/content/docs/anwender/seiten-bauen.md",
+      "file": "src/content/docs/anwender/seiten-bauen.mdx",
       "kind": "hollow",
       "msg": "Marker \"Platzhalter\": Die kleine Vorschau benötigt nach der Bildauswahl einen Moment. Ein Platzhalterbild ist in dieser Phase normal",
       "line": 45
     },
     {
-      "file": "src/content/docs/einstieg/neues-projekt.md",
+      "file": "src/content/docs/einstieg/neues-projekt.mdx",
       "kind": "hollow",
       "msg": "Marker \"Platzhalter\": ## 2. Platzhalter und Starter-Reste",
       "line": 26
     },
     {
-      "file": "src/content/docs/einstieg/schnellstart.md",
+      "file": "src/content/docs/einstieg/schnellstart.mdx",
       "kind": "hollow",
       "msg": "Marker \"noch nicht\": - `project not found` → Projektdateien liegen da, aber das Projekt ist im laufenden tibi-server noch nicht reg",
       "line": 48
     },
     {
-      "file": "src/content/docs/einstieg/schnellstart.md",
+      "file": "src/content/docs/einstieg/schnellstart.mdx",
       "kind": "hollow",
       "msg": "Marker \"Platzhalter\": ## 2. Platzhalter ersetzen",
       "line": 21
     },
     {
-      "file": "src/content/docs/einstieg/was-ist-tibi.md",
+      "file": "src/content/docs/einstieg/was-ist-tibi.mdx",
       "kind": "hollow",
       "msg": "Marker \"Platzhalter\": - **Projekt-Website (aus `tibi-svelte-starter` geklont):** eigenständige Website auf Tibi-Basis — normale klei",
       "line": 11
     },
     {
-      "file": "src/content/docs/projekt/deploy.md",
+      "file": "src/content/docs/projekt/deploy.mdx",
       "kind": "hollow",
       "msg": "Marker \"Platzhalter\": Im Starter stehen Platzhalter (`__PROJECT_NAME__`, `_CUSTOMER_ID_`, `LIVE_URL=https://www`).",
       "line": 26
diff --git a/plans/doku-ausbau.md b/plans/doku-ausbau.md
index 22e711e..26724c9 100644
--- a/plans/doku-ausbau.md
+++ b/plans/doku-ausbau.md
@@ -57,7 +57,7 @@ Jede Fähigkeit von tibi-server / tibi-admin braucht genau eine Dokustelle. Der
 | jobs (Cron) + actions | projekt/jobs-actions | ✅ |
 | snapshots + backup/restore | projekt/audit-backup | ✅ |
 | search (Textindex, RRF-Hybrid, Regenerate) | projekt/suche (+ projekt/sammlungen-anlegen für Index-YAML) | ✅ |
-| embedding + vectorindex | projekt/suche (Kurzüberblick) | ✅ |
+| embedding + vectorindex (inkl. Failover-Gruppen, Startprüfung/Quarantäne/Rückkehr, `goldenPath`, Status-Endpunkte) | server/konfiguration (Gruppen im Detail), server/betrieb (Status/Störungen), projekt/suche (Kurzüberblick) | ✅ |
 | rankfusion (RRF-Formel) | projekt/suche | ✅ |
 | permissions (public/user/token, Orgs/Teams-Matrix) | projekt/rechte-tokens | ✅ |
 | filecleanup (automatisch, keine Config-Fläche) | kein eigener Artikel — Einzeiler in server/betrieb prüfen (T-FINISH) | ⏳ |
@@ -182,6 +182,7 @@ Vollständige Prüfung von Code und Doku, dann Abarbeitung in Wellen. Übersicht
 | F | P8 Meta (AGENTS.md, Werkzeuge, Issues) | ✅ |
 | — | P9 Repo-Hygiene: 5 Alt-Kopien gelöscht (~6,1 GB), 6 mit unpushed Commits behalten | ✅ |
 | H | Ton: Fehlerabschnitte auf Handbuch-Sprache (Regel in AGENTS.md §1, 12 Anwender-Seiten + 5 Stellen) | ✅ |
+| I | Darstellung: Inline-Code-Chips für Dark Mode, 58 Seiten auf `.mdx` (Komponenten rendern jetzt), Render-Prüfung im Audit-Skript | ✅ |
 | — | Issues in den Nachbar-Repos (13) | ✅ tibi-server #42–#48, tibi-admin-nova #2–#5, tibi-types #3/#4 |
 
 **Neue Werkzeuge:** `scripts/audit-docs.mjs` (Struktur-/Link-/Bildprüfung, `plans/audit-report.json`),
diff --git a/plans/offene-issues.md b/plans/offene-issues.md
index 27f42a3..66ba33a 100644
--- a/plans/offene-issues.md
+++ b/plans/offene-issues.md
@@ -1,6 +1,6 @@
 # Offene Punkte in den Nachbar-Repos (bereit zum Anlegen als Issue)
 
-Stand: 2026-10-17 · **alle 13 Issues sind angelegt** (Gitea, Repos `cms/tibi-server`, `cms/tibi-admin-nova`, `cms/tibi-types`); Nummer je Zeile in der ersten Spalte.
+Stand: 2026-10-17 · **alle 14 Issues sind angelegt** (Gitea, Repos `cms/tibi-server`, `cms/tibi-admin-nova`, `cms/tibi-types`); Nummer je Zeile in der ersten Spalte.
 
 Stand: 2026-10-17 (erste Fassung). Alle Punkte sind am Code belegt und aus dem Doku-Audit entstanden
 (`plans/doku-audit.md`). Je Eintrag: Titel für das Issue, Repo, Beleg, Auswirkung, Vorschlag.
@@ -26,6 +26,8 @@ Stand: 2026-10-17 (erste Fassung). Alle Punkte sind am Code belegt und aus dem D
 | A3 **#4** | Wiederherstellen-Dialog nur bei Änderungen sichtbar | `AuditRestoreDialog.svelte` — Feldauswahl erscheint nur bei ungespeicherten Änderungen, sonst „Keine Änderungen" | Doku muss den Sonderfall erklären; im Audit erwähnt | Hinweistext im UI prüfen |
 | A4 **#3** | Actions fehlen im Mock-Projekt `corporate` | `frontend/assets/mock/_config/corporate/config.yml` hatte keinen `actions`-Block (nur `t1`) | Screenshots/Reviews ohne aussagekräftiges Demo-Projekt (erledigt in der Doku-Arbeit, s. u.) | übernommen: `actions/reindex-search.yml` + `meta.exports` in `corporate` ergänzt |
 
+| A5 **#6** | ASCII-Umschreibungen in UI-Texten | `frontend/src/lib/i18n/locales/de.json:178` („ausfuehrbare Methode fuer diese Aktion"), `:194` („vor dem Ausfuehren") | Rechtschreibfehler im deutschen UI; Doku zitiert die Texte wörtlich | Umlaute korrigieren (`ausführbare`, `für`, `Ausführen`) |
+
 ## tibi-types
 
 | # | Titel | Beleg | Auswirkung | Vorschlag |
diff --git a/scripts/audit-docs.mjs b/scripts/audit-docs.mjs
index 0376bbd..f1d2f67 100644
--- a/scripts/audit-docs.mjs
+++ b/scripts/audit-docs.mjs
@@ -179,6 +179,18 @@ for (const f of files) {
     if (!im[1].trim()) add(f, 'image', 'Bild ohne Alt-Text', line);
   }
 
+  // Komponente genutzt, aber nicht importiert (rendert dann als rohes HTML)
+  const usedComponents = new Set(
+    [...text.matchAll(/<(Aside|Steps|Tabs|TabItem|Card|CardGrid|LinkCard|Badge|FileTree)\b/g)].map((m) => m[1]),
+  );
+  const imported = new Set(
+    ([...text.matchAll(/^import\s*\{([^}]*)\}/gm)].flatMap((m) => m[1].split(',').map((s) => s.trim()))),
+  );
+  for (const c of usedComponents) {
+    if (!imported.has(c) && f.endsWith('.mdx')) add(f, 'import', `Komponente <${c}> genutzt, aber nicht importiert`);
+    if (!f.endsWith('.mdx')) add(f, 'import', `Komponente <${c}> in einer .md-Datei — Datei muss .mdx sein`);
+  }
+
   // Starlight-Komponenten
   for (const c of new Set(STARLIGHT_COMPONENTS)) {
     const n = (text.match(new RegExp(`<${c}[\\s/>]`, 'g')) ?? []).length;
@@ -248,6 +260,26 @@ for (const f of files) {
   if (badAdmin) stats.tibiAdminRefs.push(`${rel(f)} (${badAdmin.length}×)`);
 }
 
+// --- Render-Prüfung gegen dist/ (Komponenten müssen echt gerendert sein) ----
+const DIST = path.join(ROOT, 'dist');
+const renderFindings = [];
+if (fs.existsSync(DIST)) {
+  const htmlFiles = walk(DIST).filter((f) => f.endsWith('.html'));
+  const RAW_TAG = /<(Aside|Steps|Tabs|TabItem|Card|CardGrid|LinkCard|Badge|FileTree)[\s/>]/;
+  for (const f of htmlFiles) {
+    const html = fs.readFileSync(f, 'utf8');
+    if (html.includes('astrojs/starlight/components')) {
+      renderFindings.push({ file: rel(f), kind: 'render', msg: 'import-Zeile steht sichtbar im HTML (Seite ist .md statt .mdx)', line: null });
+    }
+    const m = RAW_TAG.exec(html);
+    if (m) {
+      renderFindings.push({ file: rel(f), kind: 'render', msg: `Komponenten-Tag <${m[1]}> ungerendert im HTML (Seite ist .md statt .mdx)`, line: null });
+    }
+  }
+} else {
+  renderFindings.push({ file: 'dist/', kind: 'render', msg: 'dist/ fehlt — zuerst `npm run build` laufen lassen', line: null });
+}
+
 // --- Sidebar-Abgleich -----------------------------------------------------
 const cfg = fs.readFileSync(path.join(ROOT, 'astro.config.mjs'), 'utf8');
 const sidebarSlugs = [...cfg.matchAll(/slug:\s*'([^']+)'/g)].map((m) => m[1]);
@@ -259,10 +291,10 @@ const report = {
   generatedAt: new Date().toISOString(),
   stats,
   sidebar: { count: sidebarSlugs.length, notInSidebar, sidebarMissing },
-  findings,
+  findings: [...findings, ...renderFindings],
   summary: {
-    total: findings.length,
-    byKind: findings.reduce((a, f) => ({ ...a, [f.kind]: (a[f.kind] ?? 0) + 1 }), {}),
+    total: findings.length + renderFindings.length,
+    byKind: [...findings, ...renderFindings].reduce((a, f) => ({ ...a, [f.kind]: (a[f.kind] ?? 0) + 1 }), {}),
   },
 };
 
diff --git a/src/content/docs/admin/aktionen.md b/src/content/docs/admin/aktionen.mdx
similarity index 91%
rename from src/content/docs/admin/aktionen.md
rename to src/content/docs/admin/aktionen.mdx
index ea91d60..b8d5bf9 100644
--- a/src/content/docs/admin/aktionen.md
+++ b/src/content/docs/admin/aktionen.mdx
@@ -45,7 +45,10 @@ meta:
 | `execution.cancellable` | Schema-seitig vorgesehen, im Frontend **ohne Verwendung** (kein Abbruch-Knopf; `grep` über `frontend/src` findet keine Auswertung) — lang laufende Actions brechen nur über SSE-Ende oder Netzwerkfehler ab |
 | Upload-Fortschritt | Enthält `data` Datei-Bytes (`hasInlineUploadPayload`), erzeugt `runAction` einen Byte-Toast (`createByteProgressToast`, `ActionView.svelte:350-357`) und füttert ihn per `onUploadProgress` (`ActionView.svelte:377`) — Erfolgs-Toast erst nach Server-Antwort |
 
-<Aside type="note">Fortschritt während der Ausführung kommt ausschließlich aus SSE-Events plus `output.mapping.progress` (siehe Reiter oben) — `execution` steuert daran nichts.</Aside>
+<Aside type="note">
+Fortschritt während der Ausführung kommt ausschließlich aus SSE-Events plus `output.mapping.progress` (siehe Reiter oben) — `execution` steuert daran nichts.
+
+</Aside>
 
 ![Action-Ansicht im tibi-admin: Methoden-Reiter GET und POST, Eingabeformular mit den Feldern Kollektion und Versteckte einschliessen sowie Ausführen-Knopf](../../../assets/admin/admin-aktionen.webp)
 
@@ -85,7 +88,10 @@ Liefert die Action Live-Events (`Content-Type: text/event-stream`), zeigt `Actio
 - Status- und Meldungstext aus `progress.statusField` / `progress.messageField`.
 - Optionale Zusatzfelder (`progress.fields`) aus jedem Event.
 
-<Aside type="note">Ohne `output.mapping.progress` in der Action-Meta gibt es bewusst **keinen** Balken — ein 0-%-Balken bei jeder alten Action wäre irreführend. Dann bleibt JSON das Ergebnis.</Aside>
+<Aside type="note">
+Ohne `output.mapping.progress` in der Action-Meta gibt es bewusst **keinen** Balken — ein 0-%-Balken bei jeder alten Action wäre irreführend. Dann bleibt JSON das Ergebnis.
+
+</Aside>
 
 </TabItem>
 </Tabs>
@@ -105,7 +111,10 @@ Formular (query + data) → Ausführen → [SSE-Events → Balken] → Ergebnis
 | `permission` / `not found` | Falscher Kopf oder Action gelöscht | [Token-Köpfe](/reference/token-koepfe/) und Action-Namen prüfen |
 | Netzwerkfehler | Server nicht erreichbar | [Admin einrichten](/admin/setup/) prüfen, erneut versuchen |
 
-<Aside type="caution">Actions können Daten ändern. Starte eine unbekannte Action erst in einer Testumgebung — der Verlauf (`_actions/<name>` im Audit) zeigt nur, was bereits lief.</Aside>
+<Aside type="caution">
+Actions können Daten ändern. Starte eine unbekannte Action erst in einer Testumgebung — der Verlauf (`_actions/<name>` im Audit) zeigt nur, was bereits lief.
+
+</Aside>
 
 Klick-Abläufe dazu stehen im Test-Plan `docs/test-plans/40-actions.md` (Methoden-Tabs, ausführbar vs. gesperrt, Ergebnis und Fortschritt).
 
diff --git a/src/content/docs/admin/ansichten-listen.md b/src/content/docs/admin/ansichten-listen.mdx
similarity index 100%
rename from src/content/docs/admin/ansichten-listen.md
rename to src/content/docs/admin/ansichten-listen.mdx
diff --git a/src/content/docs/admin/benutzer-rechte.md b/src/content/docs/admin/benutzer-rechte.mdx
similarity index 96%
rename from src/content/docs/admin/benutzer-rechte.md
rename to src/content/docs/admin/benutzer-rechte.mdx
index 771d9d2..ab2300e 100644
--- a/src/content/docs/admin/benutzer-rechte.md
+++ b/src/content/docs/admin/benutzer-rechte.mdx
@@ -121,7 +121,10 @@ admin:
       allowSnapshots: true
 ```
 
-<Aside type="caution">Fehlt ein Flag, scheitert die Operation serverseitig — der Admin zeigt dann einen Rechte-Fehler. Vergib nur, was das Projekt wirklich braucht.</Aside>
+<Aside type="caution">
+Fehlt ein Flag, scheitert die Operation serverseitig — der Admin zeigt dann einen Rechte-Fehler. Vergib nur, was das Projekt wirklich braucht.
+
+</Aside>
 
 ## Stellvertretung (Impersonation)
 
@@ -133,7 +136,10 @@ Admins können sich als ein Benutzerkonto anmelden, um dessen Sicht zu prüfen:
 | Erkennen | Banner/Status zeigt die Stellvertretung (`AdminLayout`, `AdminHub`, `UserDetailDrawer`) |
 | Beenden | `POST /login/impersonate?logout=1` → Server löscht den Stellvertretungs-Cookie und stellt die Admin-Sitzung wieder her |
 
-<Aside type="caution">Stellvertretung nur mit Freigabe nutzen — du handelst mit den Rechten der vertretenen Person, und der Vorgang wird protokolliert (Audit). Währenddessen keine Token erstellen.</Aside>
+<Aside type="caution">
+Stellvertretung nur mit Freigabe nutzen — du handelst mit den Rechten der vertretenen Person, und der Vorgang wird protokolliert (Audit). Währenddessen keine Token erstellen.
+
+</Aside>
 
 ## Fehler
 
diff --git a/src/content/docs/admin/customizing.md b/src/content/docs/admin/customizing.mdx
similarity index 95%
rename from src/content/docs/admin/customizing.md
rename to src/content/docs/admin/customizing.mdx
index d0fe47e..11c6320 100644
--- a/src/content/docs/admin/customizing.md
+++ b/src/content/docs/admin/customizing.mdx
@@ -71,7 +71,10 @@ Volle Kontext-Tabelle in der Repo-Doku `custom-export-script.md`; Bedienung unte
 </TabItem>
 </Tabs>
 
-<Aside type="caution">Anpassungen an Sammlungs-Config und Skripten erst im lokalen Stack ([einrichten](/admin/setup/)) testen — falsche `meta`-Einträge blenden Ansichten oder Export-Reiter ersatzlos aus.</Aside>
+<Aside type="caution">
+Anpassungen an Sammlungs-Config und Skripten erst im lokalen Stack ([einrichten](/admin/setup/)) testen — falsche `meta`-Einträge blenden Ansichten oder Export-Reiter ersatzlos aus.
+
+</Aside>
 
 ![Angepasste Listenansicht im tibi-admin: Seitenliste mit Filter-Reitern und geöffnetem Export-Dialog mit den eigenen Export-Reitern Seiten-Report und Seiten-CSV](../../../assets/admin/admin-customizing.webp)
 
diff --git a/src/content/docs/admin/eintrags-editor.md b/src/content/docs/admin/eintrags-editor.mdx
similarity index 100%
rename from src/content/docs/admin/eintrags-editor.md
rename to src/content/docs/admin/eintrags-editor.mdx
diff --git a/src/content/docs/admin/exporte.md b/src/content/docs/admin/exporte.mdx
similarity index 100%
rename from src/content/docs/admin/exporte.md
rename to src/content/docs/admin/exporte.mdx
diff --git a/src/content/docs/admin/ki-funktionen.md b/src/content/docs/admin/ki-funktionen.mdx
similarity index 89%
rename from src/content/docs/admin/ki-funktionen.md
rename to src/content/docs/admin/ki-funktionen.mdx
index cc1dce0..c06966b 100644
--- a/src/content/docs/admin/ki-funktionen.md
+++ b/src/content/docs/admin/ki-funktionen.mdx
@@ -42,7 +42,7 @@ Was die KI dabei sieht (`aiController.ts`, `AiChat.svelte`): Neben dem UI-Snapsh
 
 Das **„Kontextfenster“** liest der Chat aus dem Modellkatalog (Endpunkt `/api/ai/models`, `configured.chat.contextWindow`); antwortet der Katalog nicht, gelten 96 000 Token (`MODEL_CONTEXT_WINDOW`). Aktuell meldet der Proxy 262 144 (siehe `config/ai-proxy.config.json`, `chat.contextWindow`).
 
-Tempo der Cursor-Animation: **„Nova-Speed“** mit **„Hyperspeed“** (0, alles sofort), **„Schnell“** (1, Standard), **„Mittel“** (2), **„Langsam“** (3) — als Befehle (**„Nova-Speed: …“**) und Kennung `ai-animation-speed` in `localStorage`. Bei zu vielen Schritten stoppt Nova von selbst: „Automatisch gestoppt – zu viele aufeinanderfolgende Aktionen. Nova wurde nach {count} Schritten angehalten …“ — dann Anfrage neu formulieren oder Felder manuell prüfen.
+Tempo der Cursor-Animation: **„Nova-Speed“** mit **„Hyperspeed“** (0, alles sofort), **„Schnell“** (1, Standard), **„Mittel“** (2), **„Langsam“** (3) — als Befehle (**„Nova-Speed: …“**) und Kennung `ai-animation-speed` in `localStorage`. Bei zu vielen Schritten stoppt Nova von selbst: „Automatisch gestoppt – zu viele aufeinanderfolgende Aktionen. Nova wurde nach \{count\} Schritten angehalten …“ — dann Anfrage neu formulieren oder Felder manuell prüfen.
 
 ## Zusammenfassen
 
@@ -57,8 +57,8 @@ Wächst ein Gespräch Richtung Kontextgrenze, komprimiert `lib/aiSummarizer.ts`
 - Reserviert sind 10 000 Token für System-Prompt, Werkzeug-Definitionen und Antwort (`RESERVED_TOKENS`).
 - Zusammenfassungs-Modell: `proxy-managed` — auch hier entscheidet der Proxy, nicht das Frontend. Der Aufruf geht an den Zusammenfassungs-Endpunkt mit Profil `summarizer` und liest einen SSE-Strom (inkl. Zähler); Antwort leer oder Netzfehler → Rückfall auf hartes Kürzen.
 - Hartes Kürzen hält Werkzeug-Paare zusammen: Verwaiste `tool`-Antworten und `assistant`-Nachrichten ohne vollständige Ergebnisse fliegen raus (`hardTruncate`, `sanitizeWireMessages`) — sonst würde die API den Turn ablehnen.
-- UI: Währenddessen steht **„Kontext wird zusammengefasst…“**, danach **„Kontext zusammengefasst“** bzw. **„Zusammenfassung aktiv“** mit **„{count} Nachrichten komprimiert · ~{tokens} Tokens gespart“**.
-- Themenwechsel: Schlägt Nova einen neuen Chat vor (**„Neuen Chat starten?“** — **„Neuen Chat starten“** oder **„Nein, weiter“**), fasst `summarizeForTransfer` den ganzen Verlauf zusammen und stellt deine letzte Nachricht wörtlich unter „LATEST REQUEST“. Im neuen Chat erscheint das als **„Kontext aus vorherigem Chat“** (**„{count} Nachrichten aus vorherigem Chat · ~{tokens} Tokens übertragen“**).
+- UI: Währenddessen steht **„Kontext wird zusammengefasst…“**, danach **„Kontext zusammengefasst“** bzw. **„Zusammenfassung aktiv“** mit **„\{count\} Nachrichten komprimiert · ~\{tokens\} Tokens gespart“**.
+- Themenwechsel: Schlägt Nova einen neuen Chat vor (**„Neuen Chat starten?“** — **„Neuen Chat starten“** oder **„Nein, weiter“**), fasst `summarizeForTransfer` den ganzen Verlauf zusammen und stellt deine letzte Nachricht wörtlich unter „LATEST REQUEST“. Im neuen Chat erscheint das als **„Kontext aus vorherigem Chat“** (**„\{count\} Nachrichten aus vorherigem Chat · ~\{tokens\} Tokens übertragen“**).
 
 ## Stimme
 
@@ -84,7 +84,7 @@ Antworten anhören statt lesen (`lib/aiTTS.ts`, Endpunkt `/api/ai/tts`) — Knop
 | Tempo | **„Geschwindigkeit“** 0,5–2,0, Schritt 0,1, Standard **1,3** (**„Zurücksetzen“** stellt den Standard wieder her) |
 | Format | MP3 (`responseFormat: mp3`) — Opus im WebM, wenn dein Browser es kann (`preferredTTSFormat`) |
 
-Verhalten: Quelle zuerst Browser-**„Systemstimme auf diesem Gerät“** (passend zu deiner Dokumentsprache, Standard `de-DE`), sonst **„KI-Stimme“** (Proxy-Modell `qwen3-tts-0.6b-base`) — Anzeige **„Stimme: {voice}“**. Beim Streamen spricht Nova satzweise mit: erster Block ab ~60 Zeichen, danach ~120-Zeichen-Bündel, bis zu 2 parallele Anfragen, lückenlos aneinandergereiht. Schalter **„Sprachausgabe“** / **„Sprachausgabe aus“**; Zeichen und Kosten meldet der Server per Kopf (`X-AI-Characters`, `X-AI-Cost-Usd`) und landen unter **„Sprachausgabe“** in **„Konversation gesamt“**.
+Verhalten: Quelle zuerst Browser-**„Systemstimme auf diesem Gerät“** (passend zu deiner Dokumentsprache, Standard `de-DE`), sonst **„KI-Stimme“** (Proxy-Modell `qwen3-tts-0.6b-base`) — Anzeige **„Stimme: \{voice\}“**. Beim Streamen spricht Nova satzweise mit: erster Block ab ~60 Zeichen, danach ~120-Zeichen-Bündel, bis zu 2 parallele Anfragen, lückenlos aneinandergereiht. Schalter **„Sprachausgabe“** / **„Sprachausgabe aus“**; Zeichen und Kosten meldet der Server per Kopf (`X-AI-Characters`, `X-AI-Cost-Usd`) und landen unter **„Sprachausgabe“** in **„Konversation gesamt“**.
 
 </TabItem>
 </Tabs>
@@ -93,7 +93,7 @@ Zusatz: **Vision** (`/api/ai/vision`) beschreibt Bilder für CMS-Felder („erfi
 
 ## Werkzeuge
 
-Die KI ruft UI-Werkzeuge statt zu raten (`aiTools.ts` → `aiController.ts`). Labels wörtlich aus `de.json` (`admin.ai.tools.*`); Status dazu: **„Arbeitet…“** währenddessen, danach **„1 Aktion ausgeführt“** bzw. **„{count} Aktionen ausgeführt“**, **„Details“** öffnet den **„Tool-Inspector“** (**„Tool-Aufruf“** / **„Tool-Rückgabe“**, **„Formatiert“** / **„Roh“**, **„Alle Schritte kopieren“**):
+Die KI ruft UI-Werkzeuge statt zu raten (`aiTools.ts` → `aiController.ts`). Labels wörtlich aus `de.json` (`admin.ai.tools.*`); Status dazu: **„Arbeitet…“** währenddessen, danach **„1 Aktion ausgeführt“** bzw. **„\{count\} Aktionen ausgeführt“**, **„Details“** öffnet den **„Tool-Inspector“** (**„Tool-Aufruf“** / **„Tool-Rückgabe“**, **„Formatiert“** / **„Roh“**, **„Alle Schritte kopieren“**):
 
 | Gruppe | Werkzeuge (UI-Name) |
 |---|---|
@@ -113,7 +113,10 @@ Die KI ruft UI-Werkzeuge statt zu raten (`aiTools.ts` → `aiController.ts`). La
 
 Stapel-Limits (`aiTools.ts`): `run_tool_batch` fasst bis zu 40 ändernde Schritte (100 bei rein lesenden wie **„Kontext abrufen“**, **„Projekte auflisten“**, **„Benutzer auflisten“**) — darüber verweigert der Batch. `get_context` (**„Kontext abrufen“**) und `get_entry_context` lesen gezielt nach: Standardablauf ist erst Eintrag öffnen, dann `get_entry_context`, dann die Feld-Updates möglichst als ein Batch.
 
-<Aside type="note">Alle Aktionen sind nicht destruktiv angelegt; `prepare_bulk_delete` bereitet nur vor und `restore_from_audit` (**„Aus Audit übernehmen"**) fragt vorher bei dir nach. Zwei Debug-Ansichten: `AiDebugContext.svelte` (Befehlspalette: **„Debug: KI-Kontext anzeigen"**) zeigt, welchen Kontext die KI gerade sieht; `AiVisionOverlay.svelte` (Befehlspalette: **„Debug: KI-Vision"**, Schalter **„Debug: KI-Vision (steuerbare Elemente anzeigen)"**) legt ein Röntgen-Overlay über alle steuerbaren Elemente mit ihren Kennungen.</Aside>
+<Aside type="note">
+Alle Aktionen sind nicht destruktiv angelegt; `prepare_bulk_delete` bereitet nur vor und `restore_from_audit` (**„Aus Audit übernehmen"**) fragt vorher bei dir nach. Zwei Debug-Ansichten: `AiDebugContext.svelte` (Befehlspalette: **„Debug: KI-Kontext anzeigen"**) zeigt, welchen Kontext die KI gerade sieht; `AiVisionOverlay.svelte` (Befehlspalette: **„Debug: KI-Vision"**, Schalter **„Debug: KI-Vision (steuerbare Elemente anzeigen)"**) legt ein Röntgen-Overlay über alle steuerbaren Elemente mit ihren Kennungen.
+
+</Aside>
 
 ## Grenzen und Kosten
 
@@ -137,7 +140,7 @@ Wichtig zur Einordnung: Der Admin-Chat läuft über den Proxy (`/api/ai/chat`, `
 | **„Rate-Limit erreicht. Bitte warte einen Moment und versuche es erneut.“** | 429 am Proxy | Kurz warten, erneut versuchen |
 | **„Der KI-Dienst ist vorübergehend nicht erreichbar. Bitte versuche es später erneut.“** | 5xx am Proxy | Später erneut versuchen |
 | **„Mikrofon-Zugriff verweigert. …“** | Browser-Recht fehlt | Mikrofon in den Browser-Einstellungen freigeben |
-| **„Transkription fehlgeschlagen: {error}“** | Rate-Limit, Netz oder Proxy-Fehler | Kürzeren Abschnitt sprechen, erneut versuchen |
+| **„Transkription fehlgeschlagen: \{error\}“** | Rate-Limit, Netz oder Proxy-Fehler | Kürzeren Abschnitt sprechen, erneut versuchen |
 | Stimme klingt falsch | Andere Stimme aktiv | Stimme in den KI-Einstellungen zurück auf `eva-de` setzen |
 
 ![Geöffneter Nova-Chat im tibi-admin: Begrüßungsnachricht, Eingabefeld mit Mikrofon-Knopf und Sammlungsübersicht des Corporate-Projekts dahinter](../../../assets/admin/admin-ki-funktionen.webp)
diff --git a/src/content/docs/admin/konzept.md b/src/content/docs/admin/konzept.mdx
similarity index 100%
rename from src/content/docs/admin/konzept.md
rename to src/content/docs/admin/konzept.mdx
diff --git a/src/content/docs/admin/medien.md b/src/content/docs/admin/medien.mdx
similarity index 100%
rename from src/content/docs/admin/medien.md
rename to src/content/docs/admin/medien.mdx
diff --git a/src/content/docs/admin/setup.md b/src/content/docs/admin/setup.mdx
similarity index 97%
rename from src/content/docs/admin/setup.md
rename to src/content/docs/admin/setup.mdx
index 055769e..4969209 100644
--- a/src/content/docs/admin/setup.md
+++ b/src/content/docs/admin/setup.mdx
@@ -102,7 +102,10 @@ yarn build           # esbuild-Bundle, muss fehlerfrei durchlaufen
 yarn test:e2e        # Playwright E2E
 ```
 
-<Aside type="tip">Läuft `yarn build` grün und zeigt der Admin nach Login die Projektliste, ist das Setup fertig. Weiter geht es mit [Admin anpassen](/admin/customizing/).</Aside>
+<Aside type="tip">
+Läuft `yarn build` grün und zeigt der Admin nach Login die Projektliste, ist das Setup fertig. Weiter geht es mit [Admin anpassen](/admin/customizing/).
+
+</Aside>
 
 ![Projektliste im tibi-admin nach dem Login: Karten für Blog Platform, Corporate Website, Event Portal, Intranet, Online Shop und Test Core mit Online-Status](../../../assets/admin/admin-setup.webp)
 
diff --git a/src/content/docs/anwender/aktionen.md b/src/content/docs/anwender/aktionen.mdx
similarity index 91%
rename from src/content/docs/anwender/aktionen.md
rename to src/content/docs/anwender/aktionen.mdx
index a5e4fef..3adb737 100644
--- a/src/content/docs/anwender/aktionen.md
+++ b/src/content/docs/anwender/aktionen.mdx
@@ -16,7 +16,7 @@ import { Aside, Steps } from '@astrojs/starlight/components';
 1. Öffne das Projekt und wähle die Aktion aus der Liste.
 2. Lies oben, was die Aktion tut (Abschnitt **Methoden**).
 3. Fülle unter **Eingaben** alle benötigten Felder aus.
-4. Korrigiere markierte Felder, solange die Meldung **Bitte korrigiere {count} Feldfehler vor dem Ausfuehren.** steht.
+4. Korrigiere markierte Felder, solange die Meldung **Bitte korrigiere \{count\} Feldfehler vor dem Ausfuehren.** steht.
 5. Klicke auf **Ausführen**.
 6. Warte, bis statt **Läuft…** wieder **Ausführen** dasteht.
 
@@ -30,7 +30,7 @@ Steht statt **Ausführen** der Knopf **Gesperrt**, fehlt dem Konto die Berechtig
 
 ## Fortschritt und Ergebnis lesen
 
-Während der **Ausführung** zeigt der Bereich **Fortschritt** einen Balken mit **{percent}% abgeschlossen** oder einer Zählung wie **{index} von {count}**. Danach steht das Ergebnis unter **Letztes Ergebnis** mit **Zusammenfassung** und **Details**.
+Während der **Ausführung** zeigt der Bereich **Fortschritt** einen Balken mit **\{percent\}% abgeschlossen** oder einer Zählung wie **\{index\} von \{count\}**. Danach steht das Ergebnis unter **Letztes Ergebnis** mit **Zusammenfassung** und **Details**.
 
 <Steps>
 
diff --git a/src/content/docs/anwender/anmelden.md b/src/content/docs/anwender/anmelden.mdx
similarity index 94%
rename from src/content/docs/anwender/anmelden.md
rename to src/content/docs/anwender/anmelden.mdx
index 417a830..7f95a4c 100644
--- a/src/content/docs/anwender/anmelden.md
+++ b/src/content/docs/anwender/anmelden.mdx
@@ -47,7 +47,7 @@ Die Anmeldeadresse erhältst du von der Administration; speichere sie anschließ
 
 Kurz vor dem automatischen Abmelden erscheint der Hinweis **Sitzung läuft ab** mit der Meldung „Du wirst wegen Inaktivität gleich automatisch abgemeldet.". Wähle **Angemeldet bleiben**, um weiterzuarbeiten, oder **Jetzt abmelden**, um die Sitzung sofort zu beenden. Reagierst du nicht, meldet dich tibi-admin automatisch ab und es erscheint der Hinweis **Sitzung abgelaufen – bitte neu anmelden**.
 
-<!-- Screenshot (T-SHOTS): Hinweisdialog Sitzung läuft ab mit Angemeldet bleiben und Jetzt abmelden, Mock-Projekt corporate, Alt-Text deutsch -->
+{/* Screenshot (T-SHOTS): Hinweisdialog Sitzung läuft ab mit Angemeldet bleiben und Jetzt abmelden, Mock-Projekt corporate, Alt-Text deutsch */}
 
 <Steps>
 
diff --git a/src/content/docs/anwender/backup-einspielen.md b/src/content/docs/anwender/backup-einspielen.mdx
similarity index 81%
rename from src/content/docs/anwender/backup-einspielen.md
rename to src/content/docs/anwender/backup-einspielen.mdx
index 7dc41e7..fdc0b33 100644
--- a/src/content/docs/anwender/backup-einspielen.md
+++ b/src/content/docs/anwender/backup-einspielen.mdx
@@ -26,7 +26,7 @@ Ohne Administrator-Recht sperrt die Ansicht mit **Keine Administrator-Berechtigu
 
 ## Analyse lesen
 
-Das **Analyse-Ergebnis** nennt zuerst die Zahl der gefundenen Sammlungen (**{count} Collections gefunden**) sowie Quell-Projekt und Erstelldatum der Datei. Die Tabelle darunter listet pro **Collection** die Spalten **Dokumente**, **Medien** und **Hinweise**.
+Das **Analyse-Ergebnis** nennt zuerst die Zahl der gefundenen Sammlungen (**\{count\} Collections gefunden**) sowie Quell-Projekt und Erstelldatum der Datei. Die Tabelle darunter listet pro **Collection** die Spalten **Dokumente**, **Medien** und **Hinweise**.
 
 <Steps>
 
@@ -48,10 +48,10 @@ Lies die Analyse vollständig, bevor du fortfährst. Bei ausgeschalteter Zusamme
 
 <Steps>
 
-1. Klicke auf **Wiederherstellung starten** (mit Auswahl: **Wiederherstellung starten ({n} Collections)**).
-2. Verfolge den Fortschritt (**Stelle {name} wieder her…**) und warte auf **Wiederherstellung abgeschlossen**.
-3. Lies die Zusammenfassung: **{docs} Dokumente in {n} Collections wiederhergestellt**, dazu ggf. **{n} Mediendateien kopiert**.
-4. Beachte übersprungene Sammlungen (**{n} Collections übersprungen (existieren nicht im Ziel)**).
+1. Klicke auf **Wiederherstellung starten** (mit Auswahl: **Wiederherstellung starten (\{n\} Collections)**).
+2. Verfolge den Fortschritt (**Stelle \{name\} wieder her…**) und warte auf **Wiederherstellung abgeschlossen**.
+3. Lies die Zusammenfassung: **\{docs\} Dokumente in \{n\} Collections wiederhergestellt**, dazu ggf. **\{n\} Mediendateien kopiert**.
+4. Beachte übersprungene Sammlungen (**\{n\} Collections übersprungen (existieren nicht im Ziel)**).
 5. Öffne danach die betroffenen Sammlungen und prüfe Stichproben.
 
 </Steps>
diff --git a/src/content/docs/anwender/benutzer-teams.md b/src/content/docs/anwender/benutzer-teams.mdx
similarity index 100%
rename from src/content/docs/anwender/benutzer-teams.md
rename to src/content/docs/anwender/benutzer-teams.mdx
diff --git a/src/content/docs/anwender/eintrag-bearbeiten.md b/src/content/docs/anwender/eintrag-bearbeiten.mdx
similarity index 100%
rename from src/content/docs/anwender/eintrag-bearbeiten.md
rename to src/content/docs/anwender/eintrag-bearbeiten.mdx
diff --git a/src/content/docs/anwender/exportieren.md b/src/content/docs/anwender/exportieren.mdx
similarity index 100%
rename from src/content/docs/anwender/exportieren.md
rename to src/content/docs/anwender/exportieren.mdx
diff --git a/src/content/docs/anwender/hilfe.md b/src/content/docs/anwender/hilfe.mdx
similarity index 100%
rename from src/content/docs/anwender/hilfe.md
rename to src/content/docs/anwender/hilfe.mdx
diff --git a/src/content/docs/anwender/ki-nutzen.md b/src/content/docs/anwender/ki-nutzen.mdx
similarity index 100%
rename from src/content/docs/anwender/ki-nutzen.md
rename to src/content/docs/anwender/ki-nutzen.mdx
diff --git a/src/content/docs/anwender/lesen-suchen-filtern.md b/src/content/docs/anwender/lesen-suchen-filtern.mdx
similarity index 96%
rename from src/content/docs/anwender/lesen-suchen-filtern.md
rename to src/content/docs/anwender/lesen-suchen-filtern.mdx
index 637aa85..53c377a 100644
--- a/src/content/docs/anwender/lesen-suchen-filtern.md
+++ b/src/content/docs/anwender/lesen-suchen-filtern.mdx
@@ -57,7 +57,7 @@ Liefert die Suche keine Treffer, gehe wie folgt vor:
 
 Arbeitet deine Sammlung mit Hintergrundsuche, baut tibi-admin den **Suchindex** im Hintergrund auf. Solange Einträge offen sind, zeigt ein Hinweisbanner über der Liste „wird im Hintergrund aktualisiert" mit der Zahl der offenen Einträge. Du kannst normal weiterarbeiten; sobald der Zähler auf null steht, verschwindet das Banner von selbst. Über **Details ein-/ausblenden** siehst du den Stand je Sammlung, bei Problemen stößt **Neu aufbauen** den Aufbau erneut an.
 
-<!-- Screenshot (T-SHOTS): Suchindex-Hinweisbanner im Projekt-/Sammlungs-Header, Mock-Projekt corporate, Alt-Text deutsch -->
+{/* Screenshot (T-SHOTS): Suchindex-Hinweisbanner im Projekt-/Sammlungs-Header, Mock-Projekt corporate, Alt-Text deutsch */}
 
 ## Filtern und sortieren
 
diff --git a/src/content/docs/anwender/massenbearbeitung.md b/src/content/docs/anwender/massenbearbeitung.mdx
similarity index 84%
rename from src/content/docs/anwender/massenbearbeitung.md
rename to src/content/docs/anwender/massenbearbeitung.mdx
index 11239da..9cf3297 100644
--- a/src/content/docs/anwender/massenbearbeitung.md
+++ b/src/content/docs/anwender/massenbearbeitung.mdx
@@ -16,7 +16,7 @@ Die **Massenbearbeitung** ändert viele Einträge in einem Durchgang — zum Bei
 1. Öffne die Sammlung mit den Einträgen.
 2. Markiere die Einträge einzeln, oder nutze **Alle auswählen** für die ganze Seite.
 3. Klicke auf **Bearbeiten** (Taste `e` geht auch).
-4. Der Dialog zeigt oben **Massenoperationen** und wie viele Einträge betroffen sind (**{count} ausgewählt**).
+4. Der Dialog zeigt oben **Massenoperationen** und wie viele Einträge betroffen sind (**\{count\} ausgewählt**).
 
 </Steps>
 
@@ -33,11 +33,11 @@ Ohne Auswahl betrifft die Aktion alle Einträge der Sammlung. Brich in dem Fall
 3. Lege unter **Operationen** fest, was passieren soll (**Operation hinzufügen**, Feld wählen und Aktion wie **Setzen auf** oder **Suchen & Ersetzen** bestimmen).
 4. Öffne die **Vorschau** und lies, wie viele der ausgewählten Einträge betroffen sind.
 5. Klicke auf **Änderungen anwenden** und bestätige die Nachfrage.
-6. Warte die Meldung ab: **{count} Einträge aktualisiert** bedeutet Erfolg.
+6. Warte die Meldung ab: **\{count\} Einträge aktualisiert** bedeutet Erfolg.
 
 </Steps>
 
-Die Nachfrage warnt ehrlich: **{count} Einträge werden aktualisiert. Diese Aktion kann nicht rückgängig gemacht werden.** Lies sie, bevor du bestätigst.
+Die Nachfrage warnt ehrlich: **\{count\} Einträge werden aktualisiert. Diese Aktion kann nicht rückgängig gemacht werden.** Lies sie, bevor du bestätigst.
 
 ![Massenbearbeitung-Dialog mit einer Bedingung, zwei Operationen und geöffneter Vorschau](../../../assets/anwender/massenbearbeitung-vorschau.webp)
 
@@ -62,9 +62,9 @@ Die Massenbearbeitung lässt sich nicht rückgängig machen. Prüfe die **Vorsch
 
 | Meldung | Bedeutung (Ursache) | Vorgehen |
 | ------- | ------------------- | -------- |
-| „{done} von {total} aktualisiert, {failed} fehlgeschlagen" | Einzelne Einträge sind gescheitert (z. B. Pflichtfeld leer, fehlende Berechtigung). | Prüfe die gescheiterten Einträge einzeln. |
+| „\{done\} von \{total\} aktualisiert, \{failed\} fehlgeschlagen" | Einzelne Einträge sind gescheitert (z. B. Pflichtfeld leer, fehlende Berechtigung). | Prüfe die gescheiterten Einträge einzeln. |
 | **Füge mindestens eine Operation hinzu.** | Es ist noch keine **Operation** angelegt. | Lege unter **Operationen** mindestens eine Operation an. |
 
-Zum Löschen vieler Einträge wechsele oben auf **Löschen** — dort heißt der Knopf **Löschen** statt **Änderungen anwenden**, und die Nachfrage lautet **Möchtest du {count} Einträge wirklich unwiderruflich löschen?**.
+Zum Löschen vieler Einträge wechsele oben auf **Löschen** — dort heißt der Knopf **Löschen** statt **Änderungen anwenden**, und die Nachfrage lautet **Möchtest du \{count\} Einträge wirklich unwiderruflich löschen?**.
 
 Verifiziert am 2b091d8 2026-10-17 (tibi-admin-nova)
diff --git a/src/content/docs/anwender/medien.md b/src/content/docs/anwender/medien.mdx
similarity index 93%
rename from src/content/docs/anwender/medien.md
rename to src/content/docs/anwender/medien.mdx
index b209293..6d60c87 100644
--- a/src/content/docs/anwender/medien.md
+++ b/src/content/docs/anwender/medien.mdx
@@ -80,7 +80,7 @@ Ohne **OK** geht die Anpassung verloren. Klicke zuerst auf **OK** und speichere
 
 ## Direkt bearbeiten und KI-Beschreibung
 
-In der Upload-Warteschlange („{done} von {total} hochgeladen") bearbeitest du Einträge vor dem Hochladen: **Bearbeiten & hochladen** öffnet den Eintrag im Dialog (**Medieneintrag bearbeiten**), **Schnell-Upload** lädt ohne Bearbeitung. Große Bilder verkleinert tibi-admin automatisch („Bild auf {width}×{height} verkleinert").
+In der Upload-Warteschlange („\{done\} von \{total\} hochgeladen") bearbeitest du Einträge vor dem Hochladen: **Bearbeiten & hochladen** öffnet den Eintrag im Dialog (**Medieneintrag bearbeiten**), **Schnell-Upload** lädt ohne Bearbeitung. Große Bilder verkleinert tibi-admin automatisch („Bild auf \{width\}×\{height\} verkleinert").
 
 Fehlt die Bildbeschreibung, erstellt die KI sie selbst („KI beschreibt das Bild…" → „KI-Beschreibung bereit"). Bereits ausgefüllte Beschreibungen bleiben stehen. Bei Bedarf brichst du ab (**KI-Beschreibung abbrechen**) oder stößt sie über **Erneut versuchen** erneut an.
 
diff --git a/src/content/docs/anwender/orientierung.md b/src/content/docs/anwender/orientierung.mdx
similarity index 100%
rename from src/content/docs/anwender/orientierung.md
rename to src/content/docs/anwender/orientierung.mdx
diff --git a/src/content/docs/anwender/seiten-bauen.md b/src/content/docs/anwender/seiten-bauen.mdx
similarity index 100%
rename from src/content/docs/anwender/seiten-bauen.md
rename to src/content/docs/anwender/seiten-bauen.mdx
diff --git a/src/content/docs/anwender/sichern.md b/src/content/docs/anwender/sichern.mdx
similarity index 100%
rename from src/content/docs/anwender/sichern.md
rename to src/content/docs/anwender/sichern.mdx
diff --git a/src/content/docs/anwender/tastenkombinationen.md b/src/content/docs/anwender/tastenkombinationen.mdx
similarity index 100%
rename from src/content/docs/anwender/tastenkombinationen.md
rename to src/content/docs/anwender/tastenkombinationen.mdx
diff --git a/src/content/docs/anwender/verlauf-wiederherstellen.md b/src/content/docs/anwender/verlauf-wiederherstellen.mdx
similarity index 100%
rename from src/content/docs/anwender/verlauf-wiederherstellen.md
rename to src/content/docs/anwender/verlauf-wiederherstellen.mdx
diff --git a/src/content/docs/einstieg/neues-projekt.md b/src/content/docs/einstieg/neues-projekt.mdx
similarity index 100%
rename from src/content/docs/einstieg/neues-projekt.md
rename to src/content/docs/einstieg/neues-projekt.mdx
diff --git a/src/content/docs/einstieg/schnellstart.md b/src/content/docs/einstieg/schnellstart.mdx
similarity index 100%
rename from src/content/docs/einstieg/schnellstart.md
rename to src/content/docs/einstieg/schnellstart.mdx
diff --git a/src/content/docs/einstieg/was-ist-tibi.md b/src/content/docs/einstieg/was-ist-tibi.mdx
similarity index 100%
rename from src/content/docs/einstieg/was-ist-tibi.md
rename to src/content/docs/einstieg/was-ist-tibi.mdx
diff --git a/src/content/docs/projekt/abfragen-lesen.md b/src/content/docs/projekt/abfragen-lesen.mdx
similarity index 100%
rename from src/content/docs/projekt/abfragen-lesen.md
rename to src/content/docs/projekt/abfragen-lesen.mdx
diff --git a/src/content/docs/projekt/audit-backup.md b/src/content/docs/projekt/audit-backup.mdx
similarity index 98%
rename from src/content/docs/projekt/audit-backup.md
rename to src/content/docs/projekt/audit-backup.mdx
index 4dfb149..174a942 100644
--- a/src/content/docs/projekt/audit-backup.md
+++ b/src/content/docs/projekt/audit-backup.mdx
@@ -10,9 +10,18 @@ Drei Ebenen: Das Audit-Log protokolliert Änderungen, Snapshots frieren Datenst
 Suchbegriffe: Änderungshistorie, Verlauf, Wiederherstellen, Snapshot, Datensicherung.
 
 <CardGrid>
-  <Card title="Audit-Log">Protokolliert Änderungen — wer, wann, vorher/nachher.</Card>
-  <Card title="Snapshots">Frieren Datenstände im Ordner `snapshotPath` ein.</Card>
-  <Card title="Backups">Voll-Export als ZIP für Umzug und Ernstfall.</Card>
+  <Card title="Audit-Log">
+Protokolliert Änderungen — wer, wann, vorher/nachher.
+
+</Card>
+  <Card title="Snapshots">
+Frieren Datenstände im Ordner `snapshotPath` ein.
+
+</Card>
+  <Card title="Backups">
+Voll-Export als ZIP für Umzug und Ernstfall.
+
+</Card>
 </CardGrid>
 
 ## Audit einschalten und lesen
diff --git a/src/content/docs/projekt/dateien-bilder.md b/src/content/docs/projekt/dateien-bilder.mdx
similarity index 100%
rename from src/content/docs/projekt/dateien-bilder.md
rename to src/content/docs/projekt/dateien-bilder.mdx
diff --git a/src/content/docs/projekt/deploy.md b/src/content/docs/projekt/deploy.mdx
similarity index 100%
rename from src/content/docs/projekt/deploy.md
rename to src/content/docs/projekt/deploy.mdx
diff --git a/src/content/docs/projekt/feld-rechte.md b/src/content/docs/projekt/feld-rechte.mdx
similarity index 100%
rename from src/content/docs/projekt/feld-rechte.md
rename to src/content/docs/projekt/feld-rechte.mdx
diff --git a/src/content/docs/projekt/felder-widgets.md b/src/content/docs/projekt/felder-widgets.mdx
similarity index 100%
rename from src/content/docs/projekt/felder-widgets.md
rename to src/content/docs/projekt/felder-widgets.mdx
diff --git a/src/content/docs/projekt/hooks-schreiben.md b/src/content/docs/projekt/hooks-schreiben.mdx
similarity index 100%
rename from src/content/docs/projekt/hooks-schreiben.md
rename to src/content/docs/projekt/hooks-schreiben.mdx
diff --git a/src/content/docs/projekt/jobs-actions.md b/src/content/docs/projekt/jobs-actions.mdx
similarity index 96%
rename from src/content/docs/projekt/jobs-actions.md
rename to src/content/docs/projekt/jobs-actions.mdx
index 07b7ca0..3504d14 100644
--- a/src/content/docs/projekt/jobs-actions.md
+++ b/src/content/docs/projekt/jobs-actions.mdx
@@ -10,8 +10,14 @@ Beides sind JavaScript-Programme in der goja-Laufzeit des **tibi-server** — wi
 Suchbegriffe: Cron-Job, geplante Aufgabe, Action-Endpunkt, Kontaktformular-Backend.
 
 <CardGrid>
-  <Card title="Jobs">Laufen nach Zeitplan (Cron) — zum Beispiel Aufräumen alle 5 Minuten.</Card>
-  <Card title="Aktionen">Laufen auf Abruf per HTTP — zum Beispiel Kontaktformular oder Webhook.</Card>
+  <Card title="Jobs">
+Laufen nach Zeitplan (Cron) — zum Beispiel Aufräumen alle 5 Minuten.
+
+</Card>
+  <Card title="Aktionen">
+Laufen auf Abruf per HTTP — zum Beispiel Kontaktformular oder Webhook.
+
+</Card>
 </CardGrid>
 
 <Aside type="note">
diff --git a/src/content/docs/projekt/llm-nutzen.md b/src/content/docs/projekt/llm-nutzen.mdx
similarity index 100%
rename from src/content/docs/projekt/llm-nutzen.md
rename to src/content/docs/projekt/llm-nutzen.mdx
diff --git a/src/content/docs/projekt/mcp-nutzen.md b/src/content/docs/projekt/mcp-nutzen.mdx
similarity index 100%
rename from src/content/docs/projekt/mcp-nutzen.md
rename to src/content/docs/projekt/mcp-nutzen.mdx
diff --git a/src/content/docs/projekt/navigation-i18n.md b/src/content/docs/projekt/navigation-i18n.mdx
similarity index 100%
rename from src/content/docs/projekt/navigation-i18n.md
rename to src/content/docs/projekt/navigation-i18n.mdx
diff --git a/src/content/docs/projekt/pagebuilder-dev.md b/src/content/docs/projekt/pagebuilder-dev.mdx
similarity index 98%
rename from src/content/docs/projekt/pagebuilder-dev.md
rename to src/content/docs/projekt/pagebuilder-dev.mdx
index 02b56ab..b9ec9a0 100644
--- a/src/content/docs/projekt/pagebuilder-dev.md
+++ b/src/content/docs/projekt/pagebuilder-dev.mdx
@@ -201,7 +201,7 @@ Design-Regeln aus dem Starter (`api/config.yml`, `meta.agent.designGuide`): Svel
 | `closeTitle` | Schließen-Knopf mit ESC-Hinweis („Schließen (ESC)") | `PagebuilderOverlay.svelte:348`, `PagebuilderOverviewOverlay.svelte:725`, `de.json:596` |
 | `viewportDesktop` / `viewportTablet` / `viewportPhone` | Breiten-Presets 1280 / 768 / 375 in der Viewport-Steuerung | `PagebuilderViewportControl.svelte:23-25`, `de.json:605-607` |
 | Drill-Down-Modi `overlay` / `inline` | `overlay` (Standard): Fullscreen-Overlay mit Layer-Stack; `inline`: direkte Blockliste im Formular bei `meta.drillDown: false` | `PagebuilderOverviewOverlay.svelte:4-8,34,61,83`, `PagebuilderWidget.svelte:205,238` |
-| `blueprintMoreFields` | „+{count} weitere" — eingeklappte Restfelder auf der Blueprint-Karte | `BlueprintCard.svelte:125`, `de.json:611` |
+| `blueprintMoreFields` | „+\{count\} weitere" — eingeklappte Restfelder auf der Blueprint-Karte | `BlueprintCard.svelte:125`, `de.json:611` |
 | `blueprintChildren` | Kind-Zähler („1 Kind" / „n Kinder") | `BlueprintCard.svelte:101`, `de.json:610` |
 | `blueprintNoData` | Leertext „Keine Daten" bei fehlenden Block-Daten | `BlueprintCard.svelte:132`, `de.json:612` |
 | ESC / Blur / Drilldown | `Escape` schließt nur den obersten Layer (`isTopLayer`), vorher `activeElement.blur()`; Drilldown-Navigation übernimmt Blur selbst | `PagebuilderOverlay.svelte:190-198,244`, `PagebuilderOverviewOverlay.svelte:378-382` |
diff --git a/src/content/docs/projekt/rechte-tokens.md b/src/content/docs/projekt/rechte-tokens.mdx
similarity index 100%
rename from src/content/docs/projekt/rechte-tokens.md
rename to src/content/docs/projekt/rechte-tokens.mdx
diff --git a/src/content/docs/projekt/sammlungen-anlegen.md b/src/content/docs/projekt/sammlungen-anlegen.mdx
similarity index 100%
rename from src/content/docs/projekt/sammlungen-anlegen.md
rename to src/content/docs/projekt/sammlungen-anlegen.mdx
diff --git a/src/content/docs/projekt/ssr-website.md b/src/content/docs/projekt/ssr-website.mdx
similarity index 96%
rename from src/content/docs/projekt/ssr-website.md
rename to src/content/docs/projekt/ssr-website.mdx
index 365a37a..3916f91 100644
--- a/src/content/docs/projekt/ssr-website.md
+++ b/src/content/docs/projekt/ssr-website.mdx
@@ -133,12 +133,12 @@ Quelldatei der Vorlage ist `frontend/spa.html`. `ci-modify-config.sh` ersetzt `_
 
 | Marker | Inhalt |
 |---|---|
-| `<!--HEAD-->` | Head aus dem SSR-Render |
-| `<!--HTML-->` | Gerendertes App-HTML |
-| `<!--PRELOAD-->` | Preload-Hinweise (`scripts/preload-meta.sh`) |
+| `{/*HEAD*/}` | Head aus dem SSR-Render |
+| `{/*HTML*/}` | Gerendertes App-HTML |
+| `{/*PRELOAD*/}` | Preload-Hinweise (`scripts/preload-meta.sh`) |
 | `__TIMESTAMP__` | Build-Stempel für `/dist`-Assets (Cache-Buster, schon beim Kopieren ersetzt) |
-| `<!--SSR.ERROR-->` | Render-Fehler als Kommentar (leer im Normalfall) |
-| `<!--SSR.COMMENT-->` | Diagnose (`url`, `deps`) als Kommentar |
+| `{/*SSR.ERROR*/}` | Render-Fehler als Kommentar (leer im Normalfall) |
+| `{/*SSR.COMMENT*/}` | Diagnose (`url`, `deps`) als Kommentar |
 | `<html lang>` | Sprache aus dem URL-Präfix (`de`/`en`, sonst `de`) |
 
 Die Sammlung `ssr` (`api/collections/ssr.yml`) hält einen Eintrag je URL:
diff --git a/src/content/docs/projekt/suche.md b/src/content/docs/projekt/suche.mdx
similarity index 100%
rename from src/content/docs/projekt/suche.md
rename to src/content/docs/projekt/suche.mdx
diff --git a/src/content/docs/projekt/tests.md b/src/content/docs/projekt/tests.mdx
similarity index 100%
rename from src/content/docs/projekt/tests.md
rename to src/content/docs/projekt/tests.mdx
diff --git a/src/content/docs/reference/fehlercodes.md b/src/content/docs/reference/fehlercodes.mdx
similarity index 100%
rename from src/content/docs/reference/fehlercodes.md
rename to src/content/docs/reference/fehlercodes.mdx
diff --git a/src/content/docs/reference/hook-kontexte.md b/src/content/docs/reference/hook-kontexte.mdx
similarity index 100%
rename from src/content/docs/reference/hook-kontexte.md
rename to src/content/docs/reference/hook-kontexte.mdx
diff --git a/src/content/docs/reference/hooks-daten.md b/src/content/docs/reference/hooks-daten.mdx
similarity index 99%
rename from src/content/docs/reference/hooks-daten.md
rename to src/content/docs/reference/hooks-daten.mdx
index b450a17..2a0fab7 100644
--- a/src/content/docs/reference/hooks-daten.md
+++ b/src/content/docs/reference/hooks-daten.mdx
@@ -3,6 +3,8 @@ title: 'Hook-Referenz: Daten'
 description: 'db, cache, request, response und fs im Hook-JS: Signaturen aus internal/hook, je ein Beispiel und je ein belegter Fehlerfall.'
 ---
 
+import { Aside } from '@astrojs/starlight/components';
+
 In Hooks sprichst du diese fünf Pakete über `context` an, z. B. `context.db.find(...)` oder `context.request()`. Die Signaturen stammen aus den `// args:`- bzw. `// JS signature:`-Kommentaren in `internal/hook/context_*.go` im tibi-server; wo so ein Kommentar fehlt, ist die Signatur aus Funktionsrumpf und `_test`-Datei abgeleitet und entsprechend markiert. Jede Funktion zeigt genau einen Fehlerfall mit dem originalen Error-Text aus Code oder Tests (Status-Code aus den Hook-Tests, meist `500`).
 
 ## db – Collections lesen und schreiben
diff --git a/src/content/docs/reference/rest-system.md b/src/content/docs/reference/rest-system.mdx
similarity index 90%
rename from src/content/docs/reference/rest-system.md
rename to src/content/docs/reference/rest-system.mdx
index ebce5ea..238a6ed 100644
--- a/src/content/docs/reference/rest-system.md
+++ b/src/content/docs/reference/rest-system.mdx
@@ -12,12 +12,12 @@ Jedes dieser fünf Modelle hat dieselben fünf Routen; dazu kommen Meta- und Sco
 
 | Methode + Pfad | Zweck | Rechte |
 |---|---|---|
-| `GET /api/v1/user`, `POST /api/v1/user`, `GET /api/v1/user/:id`, `PUT /api/v1/user/:id`, `DELETE /api/v1/user/:id` | Nutzer anlegen, lesen, ändern, löschen (Passwort nie in Antworten) | Nutzer-Scope (`user.read` …) bzw. Admin-Token; Org-/Team-Zugehörigkeit schränkt ein |
-| `GET /api/v1/project`, `POST /api/v1/project`, `GET /api/v1/project/:id`, `PUT /api/v1/project/:id`, `DELETE /api/v1/project/:id` | Projekte registrieren und konfigurieren | Projekt-Scope (`project.read` …); Fremd-Orgs sind unsichtbar |
-| `GET /api/v1/org`, `POST /api/v1/org`, `GET /api/v1/org/:id`, `PUT /api/v1/org/:id`, `DELETE /api/v1/org/:id` | Mandanten (Orgs) verwalten | Org-Scope (`org.read` …); nur eigene Org |
-| `GET /api/v1/team`, `POST /api/v1/team`, `GET /api/v1/team/:id`, `PUT /api/v1/team/:id`, `DELETE /api/v1/team/:id` | Gruppen in einer Org verwalten | Team-Scope (`team.read` …) |
+| `GET /api/v1/user`, `POST /api/v1/user`, `GET /api/v1/user/:id`, `PUT /api/v1/user/:id`, `DELETE /api/v1/user/:id` | Nutzer anlegen, lesen, ändern, löschen (Passwort nie in Antworten) | Nutzer-Scope (z. B. `user.read`) bzw. Admin-Token; Org-/Team-Zugehörigkeit schränkt ein |
+| `GET /api/v1/project`, `POST /api/v1/project`, `GET /api/v1/project/:id`, `PUT /api/v1/project/:id`, `DELETE /api/v1/project/:id` | Projekte registrieren und konfigurieren | Projekt-Scope (z. B. `project.read`); Fremd-Orgs sind unsichtbar |
+| `GET /api/v1/org`, `POST /api/v1/org`, `GET /api/v1/org/:id`, `PUT /api/v1/org/:id`, `DELETE /api/v1/org/:id` | Mandanten (Orgs) verwalten | Org-Scope (z. B. `org.read`); nur eigene Org |
+| `GET /api/v1/team`, `POST /api/v1/team`, `GET /api/v1/team/:id`, `PUT /api/v1/team/:id`, `DELETE /api/v1/team/:id` | Gruppen in einer Org verwalten | Team-Scope (z. B. `team.read`) |
 | `GET /api/v1/token`, `POST /api/v1/token`, `GET /api/v1/token/:id`, `PUT /api/v1/token/:id`, `DELETE /api/v1/token/:id` | Eigene Personal-Access-Tokens (PAT) verwalten | Login-Sitzung nötig — ein PAT darf **nicht** seine eigene Verwaltung aufrufen |
-| `GET /api/v1/token/_scopes` | Katalog aller Scopes, die du aktuell vergeben darfst (gleiche Quelle wie die Anlage-Prüfung) | Nur Nutzer-Login (`X-Auth-Token`/Session); PAT → `403` |
+| `GET /api/v1/token/_scopes` | Katalog aller Scopes, die du aktuell vergeben darfst (gleiche Quelle wie die Anlage-Prüfung) | Nur Nutzer-Login (`X-Auth-Token` bzw. Session-Cookie); PAT → `403` |
 | `GET /api/v1/_meta` | Feld-Metadaten **aller** System-Modelle als `{models: {user: […], …}}` | Wie die Modell-Routen (System-Ebene) |
 | `GET /api/v1/_meta/<modell>` | Feld-Metadaten eines Modells (`user`, `project`, `org`, `team`, `token`) | Wie oben |
 
diff --git a/src/content/docs/reference/schemas.md b/src/content/docs/reference/schemas.mdx
similarity index 100%
rename from src/content/docs/reference/schemas.md
rename to src/content/docs/reference/schemas.mdx
diff --git a/src/content/docs/reference/tastatur-kurzbefehle.md b/src/content/docs/reference/tastatur-kurzbefehle.mdx
similarity index 100%
rename from src/content/docs/reference/tastatur-kurzbefehle.md
rename to src/content/docs/reference/tastatur-kurzbefehle.mdx
diff --git a/src/content/docs/reference/token-koepfe.md b/src/content/docs/reference/token-koepfe.mdx
similarity index 99%
rename from src/content/docs/reference/token-koepfe.md
rename to src/content/docs/reference/token-koepfe.mdx
index 46698a3..d0e8d6c 100644
--- a/src/content/docs/reference/token-koepfe.md
+++ b/src/content/docs/reference/token-koepfe.mdx
@@ -43,7 +43,9 @@ curl -s -X POST "$SERVER_URL/api/v1/project" \
 </Tabs>
 
 <Aside type="note" title="Zwei Login-Pfade, ein Login">
-Direkt am Server heißt die Route `/api/v1/login` (`setup.go`: Gruppe `/api/v1` + `/login`). Im Starter-Stack proxyt der Admin-Host `/api/...` auf den Server — deshalb steht im Beispiel `$ADMIN_URL/api/login`. Beide meinen denselben Login, nur auf verschiedenen Wegen.</Aside>
+Direkt am Server heißt die Route `/api/v1/login` (`setup.go`: Gruppe `/api/v1` + `/login`). Im Starter-Stack proxyt der Admin-Host `/api/...` auf den Server — deshalb steht im Beispiel `$ADMIN_URL/api/login`. Beide meinen denselben Login, nur auf verschiedenen Wegen.
+
+</Aside>
 
 ## Verwechslungs-Fallen
 
diff --git a/src/content/docs/server/betrieb.md b/src/content/docs/server/betrieb.mdx
similarity index 81%
rename from src/content/docs/server/betrieb.md
rename to src/content/docs/server/betrieb.mdx
index 542f056..2b18e68 100644
--- a/src/content/docs/server/betrieb.md
+++ b/src/content/docs/server/betrieb.mdx
@@ -54,7 +54,19 @@ Die Volltextsuche läuft pro Projekt in einem Worker. Nach Config-Änderungen mu
 | `POST /api/v1/_/:project/_/admin/reload` | Lädt Projekt-Config neu (Recht `project.reload`) |
 | `POST /api/v1/_/:project/_/admin/regenerate-search` | Baut Suchindex neu auf (`project.regenerate-search`) |
 | `GET /api/v1/_/:project/_/admin/search-worker/status` | Status des Such-Workers |
-| `GET /api/v1/_/:project/_/admin/embedding/status` | Status der Embedding-Provider |
+| `GET /api/v1/_/:project/_/admin/embedding/status` | Status der Embedding-Provider/Gruppen (`project.regenerate-search`; Fehlertexte der Mitglieder sind redigiert) |
+| `GET /api/v1/admin/embedding/status` | Derselbe Status serverweit (`server.shutdown`, mit vollen Fehlertexten) |
+
+Der Embedding-Status nennt je Gruppe die Referenz und je Mitglied `state` und `breaker`:
+
+| `state` | Bedeutung | Vorgehen |
+|---|---|---|
+| `live` | Mitglied antwortet | — |
+| `degraded` | Sicherung offen, letzte Aufrufe scheiterten | Log-Zeile des Mitglieds prüfen; `COOLDOWN_AFTER_UNHEALTHY` und `CHECK_INTERVAL` steuern die Rückkehr |
+| `quarantined` | Startprüfung fehlgeschlagen (Vektoren weichen ab, Sparse-Form anders, nicht deterministisch) | Modell/Version/Gewichte der Gegenstelle prüfen; mit `CHECK_INTERVAL > 0` kommt sie automatisch zurück, sonst Neustart |
+| `offline` | Gruppe hat kein verifiziertes Mitglied (oder Config-Fehler) | Warnzeile `embedding group … offline` im Log; Ursache in `MEMBERS`/`PREFERRED_ORDER`/Provider-Config beheben |
+
+Ist die Gruppe weg, bleiben neue Dokumente ohne Vektoren liegen (sie werden beim nächsten Schreibvorgang oder per `regenerate-search` nachgezogen) — Suchanfragen auf solche Sammlungen brechen mit einer Meldung ab, die die Gruppe nennt.
 
 ```bash title="Nach Config-Änderung: Reload plus Suchindex neu aufbauen"
 curl -X POST http://localhost:8080/api/v1/_/meinprojekt/_/admin/reload \
@@ -104,4 +116,4 @@ Waisen findest du per Dateisuche im Upload-Pfad (`media/` bzw. `uploadPath` der
 
 Begriffe wie Collection, Hook oder Namespace klärt [Begriffe](/einstieg/begriffe/). Zum Einrichten siehe [Schnellstart](/einstieg/schnellstart/).
 
-Verifiziert am 68b4278 2026-10-15 (tibi-server); Compose-Profile am e3f92eb 2026-10-14 (tibi-svelte-starter). Datei-Cleanup aus `internal/filecleanup/cleanup.go` und Aufrufern (`collection_delete.go`, `collection_bulk_delete.go`, `collection_put.go`, `hook/context_db.go`)
+Verifiziert am d272041 2026-10-17 (tibi-server); Compose-Profile am e3f92eb 2026-10-14 (tibi-svelte-starter). Datei-Cleanup aus `internal/filecleanup/cleanup.go` und Aufrufern (`collection_delete.go`, `collection_bulk_delete.go`, `collection_put.go`, `hook/context_db.go`). Embedding-Status aus `internal/controller/admin_embedding_status.go` und `internal/embedding/registry.go` (Snapshot/Health-Loop).
diff --git a/src/content/docs/server/konfiguration.md b/src/content/docs/server/konfiguration.mdx
similarity index 73%
rename from src/content/docs/server/konfiguration.md
rename to src/content/docs/server/konfiguration.mdx
index cbc2f09..fbc4d4e 100644
--- a/src/content/docs/server/konfiguration.md
+++ b/src/content/docs/server/konfiguration.mdx
@@ -149,10 +149,24 @@ EMBEDDING_GROUP_MAIN_POLICY=prefer-in-order
 EMBEDDING_GROUP_MAIN_TIMEOUT_TOTAL=30s
 ```
 
+#### Was eine Gruppe beim Start und im Betrieb tut
+
+Die vollständige Fassung steht in `tibi-server/docs/02-configuration.md`; hier die Betreiber-Kurzfassung:
+
+- **Prüfung beim Start.** Referenz ist das erste Mitglied aus `PREFERRED_ORDER`, das antwortet (zwei Versuche). Jedes weitere Mitglied muss dieselben Vektoren liefern: Kosinus ≥ 0.999, zweimal identisch (deterministische Inferenz), gleiche Sparse-Form (beide mit oder beide ohne Sparse-Vektoren) und — wenn eine Gold-Datei verankert ist — auch dagegen passen. Abweichende Mitglieder sind `quarantined`; ohne ein einziges verifiziertes Mitglied ist die Gruppe `offline`. Der Server startet trotzdem.
+- **Rückkehr.** Mit `CHECK_INTERVAL > 0` prüft der Health-Loop Quarantänisierte neu gegen die aktuelle Referenz und nimmt sie zurück, sobald sie wieder passen — auch eine `offline` Gruppe kommt so zurück. Ohne `CHECK_INTERVAL` half bisher nur ein Neustart. Nach `COOLDOWN_AFTER_UNHEALTHY` öffnet außerdem die nächste Anfrage das Mitglied wieder halb (nur ein Versuch gleichzeitig).
+- **Fehlkonfiguration** (unbekanntes Mitglied, Tippfehler in `PREFERRED_ORDER`, doppelter Gruppen- oder Mitgliedsname, Namensgleichheit mit einem Provider, abweichende Modell-Identität) macht die Gruppe `offline` plus Warnzeile im Log — nie den ganzen Server.
+- **Timeouts.** Der bevorzugte Member läuft in das Gruppen-`TIMEOUT_PER_ATTEMPT`; ein Ausweich-Member bekommt `max(Provider-Timeout, Gruppen-Timeout)`, damit ein kurzes Gruppen-Timeout einen kalten lokalen Fallback nicht abschneidet — beim Bulk-Schreiben genauso. Bei `POLICY=fastest-wins` oder `HEDGE_AFTER_SLOW` immer `TIMEOUT_TOTAL` setzen. Sind alle Sicherungen offen, antwortet die Gruppe sofort mit Fehler, statt die Gegenstellen zu bombardieren.
+- **Dense-only-Endpoints bleiben kompatibel:** fehlen Sparse-Vektoren, obwohl `SPARSE` aktiv ist, liefert der Provider weiter dense-only Treffer (Hybrid-Suche fällt auf dense zurück) und schreibt einmalig eine Warnung; `SPARSE=false` schaltet sie stumm. Innerhalb einer **Gruppe** lehnt die Prüfung ein Mitglied mit abweichender Sparse-Form ab, damit ein Failover nie still Sparse-Vektoren verliert.
+- **Während die Gruppe weg ist**, bleiben Dokumente liegen: Der Batch-Weg meldet sie dem Aufrufer als offen, einzelne Schreibvorgänge lassen den Such-Eintrag stehen. Nachziehen per nächstem Schreibvorgang, `regenerate-search` oder `autoRegenerate`; Suchanfragen brechen mit einer Meldung ab, die die Gruppe beim Namen nennt.
+
 Provider-Env zum Vergleich (Provider `<NAME>` → `EMBEDDING_<NAME>_…`, ebenfalls Bindestrich zu Unterstrich):
 `APIKEY`, `TYPE`, `MODEL`, `MODELPATH`, `DIMENSIONS`, `BASEURL`, `DOCUMENTPREFIX`, `QUERYPREFIX`, `REVISION`, `TIMEOUTPERATTEMPT`, `SLOWTHRESHOLD`, `SPARSE` —
 z. B. `EMBEDDING_BGE_M3_MODELPATH`, `EMBEDDING_BGE_M3_DIMENSIONS`.
 Unbekannte `POLICY`/`DISTRIBUTION` oder ungültige Durations lassen die Gruppe mit Fehler im Log scheitern; unpassende `WEIGHTS`/`RACE_*`-Kombis geben nur eine Warnung und werden ignoriert.
+Provider- und Gruppen-Env gelten auch mit Bindestrich im Namen (`EMBEDDING_BGE-M3_TYPE`): der Server übernimmt solche Alt-Schlüssel beim Start auf die Unterstrich-Form und schreibt eine Hinweiszeile ins Log.
+
+Wo die **Gold-Dateien** für die Mitglieds-Prüfung liegen, setzt du global: `embedding.goldenPath` bzw. `EMBEDDING_GOLDEN_PATH` (Vorgabe `testdata/embedding-golden` relativ zum Arbeitsverzeichnis); erzeugen mit `go run ./cmd/embed-probe-golden`. Ohne verankerte Gold-Datei protokolliert die Gruppe das beim Start und prüft nur gegen die Referenz.
 
 ## Admin-Tokens
 
@@ -185,4 +199,4 @@ api:
 
 Weiter: [Betrieb und Beobachtung](/server/betrieb/) zeigt Profile und Metriken. [Sicherheit](/server/sicherheit/) erklärt Token-Arten und Ratelimit.
 
-Verifiziert am 68b4278 2026-10-15 (tibi-server); Starter-Compose am e3f92eb 2026-10-14 (tibi-svelte-starter); Go-Version aus `go.mod`. Upload-Kaskade aus `internal/controller/collection.go` (resolveAllowedMimeTypes), Gruppen-Env aus `internal/config/server.go` und `internal/config/embedding_group.go`.
+Verifiziert am d272041 2026-10-17 (tibi-server); Starter-Compose am e3f92eb 2026-10-14 (tibi-svelte-starter); Go-Version aus `go.mod`. Upload-Kaskade aus `internal/controller/collection.go` (resolveAllowedMimeTypes), Provider-/Gruppen-Env und `goldenPath` aus `internal/config/server.go`, Gruppen-Regeln aus `internal/config/embedding_group.go`, Prüfung/Quarantäne/Rückkehr/Timeouts aus `internal/embedding/{registry,probe,group}.go`, Pending-Verhalten aus `internal/utils/search.go`.
diff --git a/src/content/docs/server/schnittstellen.md b/src/content/docs/server/schnittstellen.mdx
similarity index 100%
rename from src/content/docs/server/schnittstellen.md
rename to src/content/docs/server/schnittstellen.mdx
diff --git a/src/content/docs/server/sicherheit.md b/src/content/docs/server/sicherheit.mdx
similarity index 100%
rename from src/content/docs/server/sicherheit.md
rename to src/content/docs/server/sicherheit.mdx
diff --git a/src/content/docs/server/uebersicht.md b/src/content/docs/server/uebersicht.mdx
similarity index 100%
rename from src/content/docs/server/uebersicht.md
rename to src/content/docs/server/uebersicht.mdx
diff --git a/src/styles/custom.css b/src/styles/custom.css
index 8784856..fcdf36e 100644
--- a/src/styles/custom.css
+++ b/src/styles/custom.css
@@ -18,6 +18,11 @@
   --tibi-sidebar: #f8f9fa;
   --tibi-topbar: #ffffff;
   --tibi-card-border: #e5e7eb;
+
+  /* Inline-Code-Chips (hell): Grau mit Rahmen statt Flaeche ohne Kante */
+  --tibi-inline-bg: #e9ecf1;
+  --tibi-inline-border: #d3d7de;
+  --tibi-inline-text: #1f2937;
 }
 
 :root[data-theme='dark'] {
@@ -29,6 +34,11 @@
   --tibi-sidebar: #16181d;
   --tibi-topbar: #16181d;
   --tibi-card-border: #333a44;
+
+  /* Inline-Code-Chips (dunkel): deutlich abgesetzt vom Seitenhintergrund (#16181d) */
+  --tibi-inline-bg: #333945;
+  --tibi-inline-border: #525b6b;
+  --tibi-inline-text: #eef1f6;
 }
 
 /* ---------- Flächen in Nova-Nähe ---------- */
@@ -114,3 +124,22 @@
 .sl-link-card:hover {
   border-color: var(--tibi-nova);
 }
+
+/* ---------- Inline-Code: eigenstaendige Chips, auch im Dark Mode lesbar ----------
+   Starlight faerbt Inline-Code nur mit --sl-color-bg-inline-code (gray-5/gray-6).
+   Im Dark Mode liegt das zu nah am Seitenhintergrund, deshalb fester Rahmen,
+   eigene Textfarbe und mehr Innenabstand. Betrifft nur Inline-Code — Codebloecke
+   (Expressive Code) bleiben unberuehrt, weil `pre > code` nicht adressiert wird. */
+.sl-markdown-content :not(pre) > code:not(:where(.not-content *)) {
+  background-color: var(--tibi-inline-bg);
+  border: 1px solid var(--tibi-inline-border);
+  border-radius: 0.3rem;
+  color: var(--tibi-inline-text);
+  font-weight: 500;
+  padding: 0.12em 0.4em;
+}
+
+/* Methoden-/Status-Spalten (etwa `GET`, `POST`, `404`) umbrechen nicht mitten im Wort */
+.sl-markdown-content td:first-child code:not(:where(.not-content *)) {
+  white-space: nowrap;
+}