metisBrain
AnmeldenJetzt testen
← Übersicht
Wissen

Dokumente & Vorlagen

Wie lege ich eine wiederverwendbare Vorlage als Markdown-Dokument an?

Systeme als versionierte Markdown-Vorlagen sichern, projektübergreifend wiederverwenden und Schritt für Schritt erweitern.

Lesezeit ~9 Min · 7 Schritte · Stand 13. Juli 2026

Das brauchst du dafür

  • Für das Anlegen und Erweitern per Chat: ein verbundener KI-Client über den MCP-Connector.
  • Der Versionsverlauf für Vorlagen gehört zum Tarif Pro und darüber.

Was ein Dokument ist

Ein Dokument ist ein Eintrag vom Typ Markdown: ein strukturierter Text, der ein System, ein Vorgehen oder ein Grundgerüst beschreibt, oft samt Code. Genau das macht es zur Vorlage, auf der du in anderen Projekten aufbaust.

  • Der Text liegt in der Datenbank (bis 20.000 Zeichen) und ist damit für Suche und KI zugänglich.
  • Zusätzlich wird eine echte .md-Datei im Object Storage abgelegt.
  • Dokumente sind projektübergreifend auffindbar, auch wenn du sie einem Projekt zuordnest.
Dokumente haben im Dashboard eine eigene Kategorie und erscheinen deshalb nicht in der Wissen-Liste bei den Notizen.

1 · Dokument im Dashboard anlegen

  • Öffne im Dashboard den Bereich Dokumente.
  • Trage einen Titel ein und schreibe den Markdown-Inhalt in das Textfeld.
  • Optional ein Projekt zuordnen.
  • Auf Profi-Vorlage einfügen klicken, wenn du ein Gerüst willst, statt bei null anzufangen.
  • Mit Dokument anlegen speichern.

Das eingefügte Gerüst sieht so aus:

Profi-Vorlage
# {Titel}

## Überblick
Kurz: Zweck, Kontext und Ziel dieses Dokuments.

## Anforderungen
-

## Aufbau / Architektur
-

## Umsetzung
1.

## Offene Punkte
-

## Änderungsverlauf
- v1 – Erstfassung

2 · Dokument im Chat anlegen

Im Chat sagst du der KI, dass etwas als Vorlage gesichert werden soll. Sie ruft dann create_md auf und übergibt Titel, Markdown-Inhalt, Tags und das Projekt dieser Unterhaltung. In Claude Code geht das auch über den Slash-Befehl /md create.

Beispielsatz an die KI
Speichere das grundlegende Registrierungs-System als Vorlage in metisBrain,
mit dem Code, und tagge es mit vorlage und auth.
Claude Code
/md create Registrierung mit E-Mail-Bestätigung und Passwort-Reset
Der Dateiname entsteht aus dem Titel: Endung .md, und alles außer Buchstaben, Ziffern, Punkt, Unterstrich, Leerzeichen und Bindestrich wird zu einem Bindestrich. Aus „Registrierung Ü-System" wird also ein Name mit Bindestrich an der Stelle des Umlauts. Der Titel im Dokument selbst bleibt davon unberührt.

3 · Auf einer Vorlage aufbauen

Der eigentliche Zweck: In einem neuen Projekt baust du auf einer bestehenden Vorlage auf, statt von vorn anzufangen. Die KI holt sich mit read_note den vollständigen Inhalt (nicht nur die Vorschau) und setzt das Neue darauf.

Beispielsatz an die KI
Erstelle eine Registrierung basierend auf meiner Registrierungs-Vorlage
und ergänze Zwei-Faktor-Authentifizierung.
  • Suche projektübergreifend: Die KI ruft read_note mit scope ALLE auf, damit auch Vorlagen aus anderen Projekten gefunden werden.
  • Sie prüft vorher, was in der Vorlage schon steht, und ergänzt nur, was fehlt.
  • Enthält die Vorlage Code, wird er als Grundlage mitgenommen.

4 · Versioniert erweitern

Wenn du eine Vorlage um ein Feature erweiterst, wird sie nicht überschrieben, sondern versioniert fortgeschrieben. Die KI nutzt dafür update_md: Sie findet das Dokument über seinen Namen, hängt mit append einen neuen Abschnitt an oder ersetzt mit replace den ganzen Inhalt, und beschreibt die Änderung kurz.

Beispielsatz an die KI
Ergänze meine Registrierungs-Vorlage um einen Abschnitt zu Magic-Link-Login
und vermerke die Änderung im Verlauf.
  • Die Versionsnummer steigt bei jeder Erweiterung: aus der Erstfassung wird v2, dann v3.
  • Zu jeder Version wird ein Eintrag im Änderungsverlauf gespeichert: Nummer, Zeitpunkt und die Kurzbeschreibung der Änderung.
  • Die .md-Datei im Object Storage wird mit dem neuen Inhalt überschrieben.
  • Auf der Karte im Dashboard siehst du die aktuelle Version (v2, v3 …).
Bearbeitest du ein Dokument im Dashboard von Hand, wird der Text ersetzt, ohne dass die Version steigt. Versionsnummer und Änderungsverlauf entstehen über update_md, also über die KI.

So sieht eine gewachsene Vorlage aus

Nach zwei Erweiterungen steht die Vorlage auf v3, und im Dokument selbst führst du den Verlauf mit:

Beispiel eines versionierten Dokuments
# Registrierung (System-Vorlage)

## Überblick
E-Mail plus Passwort, Bestätigungs-Link, Passwort-Reset.

## Umsetzung
1. Registrierung mit Hash (kein Klartext-Passwort)
2. Bestätigungs-Mail mit einmaligem Token

## Zwei-Faktor (v2)
TOTP über App, Wiederherstellungscodes bei der Aktivierung.

## Magic-Link-Login (v3)
Einmal-Link per Mail, 15 Minuten gültig, ein Login pro Link.

## Änderungsverlauf
- v1 Erstfassung
- v2 Zwei-Faktor ergänzt
- v3 Magic-Link-Login ergänzt

Was der Tarif abdeckt

  • Dokumente und Vorlagen: 5 im Tarif Start, 100 in Pro, unbegrenzt in Team.
  • Versionsverlauf für Vorlagen: ab dem Tarif Pro.
  • Speicher für die abgelegten Dateien: 250 MB (Start), 5 GB (Pro), 50 GB (Team).
  • Export als Markdown oder JSON: ab dem Tarif Pro.

Wenn es nicht klappt

Die KI meldet: „Kein MD-Dokument zu ... gefunden."
Das Dokument wird zuerst über den genauen Titel gesucht (Groß- und Kleinschreibung egal), danach über einen Treffer im Titel oder im Text. In derselben Antwort listet das Werkzeug bis zu 15 vorhandene Dokumente auf. Nenne den Titel so, wie er dort steht.
Fehler: „Bitte 'append' (anhängen) oder 'replace' (ersetzen) angeben."
Eine Aktualisierung braucht immer eine der beiden Angaben. Sag ausdrücklich, ob ein Abschnitt ergänzt (anhängen) oder der Inhalt komplett neu geschrieben (ersetzen) werden soll.
Die Version bleibt bei v1 stehen, obwohl das Dokument länger wurde.
Das Bearbeiten im Dashboard ersetzt nur den Text. Die Versionsnummer steigt und der Änderungsverlauf entsteht ausschließlich, wenn die KI das Dokument über update_md erweitert.
Langer Inhalt wird abgeschnitten.
Der durchsuchbare Text eines Eintrags ist auf 20.000 Zeichen begrenzt. Teile sehr umfangreiche Systeme auf mehrere Dokumente auf, zum Beispiel je ein Dokument pro Teilsystem, und verweise im Text aufeinander.

Häufige Fragen

Wie sage ich der KI, dass sie ein System als Vorlage speichern soll?

Sag im Chat sinngemäß: „Speichere das grundlegende System als Vorlage in metisBrain, inklusive Code." Die KI legt daraufhin ein Markdown-Dokument mit sprechendem Titel an, das im Dashboard unter Dokumente erscheint und in jedem anderen Projekt wiederverwendet werden kann.

Wie erweitere ich eine bestehende Vorlage, ohne sie zu überschreiben?

Bitte die KI, das Feature zur Vorlage zu ergänzen, zum Beispiel: „Ergänze meine Registrierungs-Vorlage um Magic-Link-Login." Sie liest zuerst den vollen Inhalt, prüft, ob es schon vorhanden ist, hängt dann den neuen Abschnitt an und erhöht dabei die Version. Der bisherige Inhalt bleibt erhalten.

Wo sehe ich, in welcher Version ein Dokument ist?

Im Dashboard steht die aktuelle Versionsnummer (v2, v3 …) direkt auf der Karte des Dokuments neben dem Titel. Zu jeder Version wird zusätzlich ein Eintrag im Änderungsverlauf gespeichert, mit Zeitpunkt und einer kurzen Beschreibung der Änderung.

Warum heißt die Datei anders als der Titel, den ich vergeben habe?

Der Dateiname wird aus dem Titel gebildet und für den Speicher bereinigt: Er bekommt die Endung .md, und Zeichen außerhalb von Buchstaben, Ziffern, Punkt, Unterstrich, Leerzeichen und Bindestrich werden durch einen Bindestrich ersetzt. Der Titel im Dokument selbst bleibt unverändert.

Wie viele Dokumente sind in meinem Tarif enthalten?

Der Tarif Start umfasst 5 Dokumente und Vorlagen, Pro 100 und Team unbegrenzt viele. Der Versionsverlauf für Vorlagen ist ab dem Tarif Pro enthalten.

Passt dazu