> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mdscribe.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Templates

> Wie Sie in MDScribe schnell robuste Templates fuer die KI-Dokumentation aufbauen.

## Templates

Templates steuern Struktur, Extraktion und Sprachstil Ihrer Ausgaben. Gute Templates sind kurz, klar und konsequent.

## Das Minimal-Prinzip

1. Jeder Abschnitt hat einen klaren Zweck.
2. Nutzen Sie nur so viele Felder wie wirklich benoetigt.
3. Fuer wiederkehrende Qualitaetsregeln nutzen Sie KI-Kommentare (`<!-- ... -->`).

## Startstruktur

```markdown theme={null}
# Dokumenttitel

## Kernbefunde
{% info "kernbefunde" /%}

## Diagnose
{% info "diagnose" /%}

## Verlauf
{% info "verlauf" /%}
```

## Tag-Referenz auf einen Blick

| Tag           | Zweck                          | Link                                            |
| ------------- | ------------------------------ | ----------------------------------------------- |
| `info`        | Einzelne Werte/Felder erfassen | [Info-Tag](/templates/info-tag)                 |
| `switch/case` | Bedingte Textbausteine         | [Switch/Case-Tags](/templates/switch-case-tags) |
| `score`       | Formeln und Berechnungen       | [Score-Tag](/templates/score-tag)               |

## Typische Fehler

* Zu viele Felder in einem einzigen Template
* Uneinheitliche Feldnamen (`Diagnose`, `diagnose`, `diag`)
* Fehlende Reihenfolgevorgaben fuer die KI
* Ungenutzte komplexe Logik, die selten gebraucht wird

## Verwaltung im Alltag

* Beim Erstellen/Bearbeiten prueft der Editor Markdoc laufend und markiert fehlerhafte Tags mit roter Wellenlinie.
* Kategorien werden als Vorschlaege aus Ihren eigenen Templates, Favoriten und haeufigen Kategorien angeboten.
* Pro Template koennen Sie bis zu 10 finale Beispiel-Ausgaben hinterlegen und spaeter direkt weiterbearbeiten.
* Templates koennen oeffentlich oder privat gespeichert werden. Oeffentliche Templates sind fuer alle Nutzer sichtbar, nutzbar und kopierbar; private Templates sieht nur der Autor.
* Private Templates sind eine Plus-Funktion. Ohne Plus koennen private Templates nur oeffentlich gespeichert werden.
* Speichern laeuft im Hintergrund: Sie erhalten sofort Feedback per Toast, inklusive Ruecksprung zum Editor bei Fehlern.
* Eigene Sammlungen helfen beim Sortieren: Erstellen Sie Sammlungen in der Sidebar und ordnen Sie Templates direkt auf der Template-Seite zu.

## Empfohlener Aufbau fuer den Launch

1. 2-3 Kerntemplates, die Sie taeglich brauchen
2. Pro Template nur die wichtigsten Abschnitte
3. Ein kurzer interner Review mit Kollegen, bevor das Template final genutzt wird

<Cards>
  <Card title="Tags im Detail" href="/templates/tags" description="Syntax, Beispiele und typische Stolpersteine." />

  <Card title="KI-Instruktionen" href="/ai/ki-instruktionen" description="So steuern Sie Stil und Struktur direkt im Template." />
</Cards>