llms.txt Generator — Manual

Zurück zur Übersicht: llms.txt Generator · Tool live öffnen: www.jpkc.com/tools/llms/

Dieses Manual beschreibt den llms.txt Generator vollständig: jedes Eingabefeld des Generators, wie aus deinen Eingaben das Markdown wird, was der Live-Checker prüft (mit allen Regeln), die Format-Referenz und die technischen Grenzen. Die Oberfläche des Tools ist auf Englisch — Tab- und Button-Namen werden hier in ihrer englischen Original-Schreibweise genannt (mit deutscher Erläuterung), damit du dich im echten Interface zurechtfindest.

Was eine llms.txt ist

Die llms.txt ist ein Vorschlag für einen Standard (von Jeremy Howard / fast.ai, dokumentiert auf llmstxt.org (englisch)): eine Markdown-Datei im Wurzelverzeichnis deiner Domain, die KI-Sprachmodellen kuratierten, akkuraten Kontext über deine Inhalte gibt. Drei Rollen erfüllt sie laut Tool:

Discovery — KI-Assistenten und Crawler prüfen /llms.txt am Domain-Root, wenn jemand nach deinem Produkt fragt; sie ist der Einstiegspunkt, vergleichbar mit einem Inhaltsverzeichnis.
Context Window — LLMs haben begrenzte Kontextfenster. Eine knappe llms.txt hilft ihnen zu entscheiden, welche Seiten sie tatsächlich abrufen, statt die ganze Site herunterzuladen.
Trust Signal — eine gepflegte llms.txt zeigt, dass dir wichtig ist, wie KI dein Projekt darstellt, und hebt die kanonischen, korrekten Informationen hervor.

Die fünf Tabs im Überblick

Das Tool gliedert sich in fünf Tabs: Generator (Formular → Markdown), Check (Live-Validator), Examples (vier Vorlagen), Tips (Best Practices) und Reference (Format-Spezifikation). Generator und Check sind die beiden Werkzeuge; Examples, Tips und Reference sind Nachschlage-Inhalte und funktionieren auch ohne Eingabe.

Der Generator-Tab

Der Generator ist zweispaltig: links das Formular (Configure your llms.txt), rechts der Output-Editor mit dem fertigen Markdown. Jede Eingabe aktualisiert die Ausgabe live (mit kurzer Verzögerung von etwa einer Drittelsekunde). Der Output-Editor ist ein schreibgeschützter ACE-Editor mit Markdown-Hervorhebung — du editierst also immer über das Formular, nie direkt im Markdown.

Name und Tagline (die Pflichtfelder)

Project / Site Name (Pflicht) — wird zur H1-Überschrift: # Name. Bleibt das Feld leer, setzt der Generator den Platzhalter # My Project.
Tagline (Pflicht) — wird zum Blockquote direkt nach dem Titel: > deine Tagline. Das Tool nennt sie ausdrücklich „das wichtigste Feld": ein einziger, klarer Satz, der erklärt, was dein Projekt genau tut. KI-Systeme lesen die Tagline oft als Erstes.

Intro-Absatz (optional)

Das Feld Intro Paragraph wird als gewöhnlicher Textabsatz nach der Tagline ausgegeben — kein Heading, kein Blockquote. Gedacht für ein bis drei Sätze zusätzlichen Kontext (Ziel, Zweck, Zielgruppe). Leer gelassen, entfällt der Absatz komplett.

Sektionen, Links und Subsektionen

Der dynamische Bereich Sections & Links ist der Kern. Über Add Section legst du beliebig viele Sektionen an; jede wird zu einer H2-Überschrift (## Name). Innerhalb einer Sektion:

Links über Add Link: drei Felder pro Zeile — Link title, URL (https://…) und Description (optional). Ausgegeben wird - [Titel](URL): Beschreibung. Ohne Beschreibung entfällt der Doppelpunkt; gibst du nur einen Titel ohne URL ein, erscheint nur der Titel; eine Zeile ganz ohne Titel und URL wird übersprungen.
Subsektionen (H3) über Add Subsection (H3): eine Sektion kann Untergruppen mit eigener Überschrift (### Name) und eigener Link-Liste enthalten. Subsektionen werden nach den direkten Links der Sektion ausgegeben. Eine Subsektion ohne Namen und ohne Links wird übersprungen.
Sortieren per Drag & Drop: Sektionen lassen sich am Griff-Symbol (dem Punktraster links) anfassen und in neue Reihenfolge ziehen — praktisch, um die wichtigste Sektion nach oben zu holen.

Leere Sektionen (kein Name, keine Links) tauchen im Output nicht auf. Mehrfache Leerzeilen werden zu einer einzigen zusammengefasst, abschließende Leerzeilen entfernt — das Markdown bleibt sauber.

Der llms-full.txt-Verweis

Das optionale Feld llms-full.txt URL verlinkt auf die kombinierte Vollinhalt-Datei (siehe unten). Trägst du hier eine URL ein, hängt der Generator automatisch eine Sektion ## Optional mit der Zeile - [llms-full.txt](URL): Complete documentation combined into a single file ans Ende.

Output: Copy, Download, Reset

Über dem Editor liegen drei Buttons:

Copy — kopiert das erzeugte llms.txt in die Zwischenablage.
Download — speichert es als Datei llms.txt (Plain-Text, UTF-8). Ist nichts eingegeben, warnt das Tool statt eine leere Datei zu erzeugen.
Reset — setzt das Formular auf den Auslieferungszustand zurück (eine leere Sektion namens „Documentation") und löscht den gespeicherten Stand.

Open File und automatisches Speichern

Mit Open File öffnest du eine vorhandene .txt-Datei: Das Tool parst sie und füllt das Formular damit, sodass du eine bestehende llms.txt bequem weiterbearbeiten kannst (Round-Trip). Unabhängig davon sichert der Generator deinen Zwischenstand lokal im Browser (LocalStorage) — schließt du den Tab und kommst zurück, ist deine Arbeit wieder da. Reset löscht diesen Speicher.

Der Check-Tab: live prüfen und validieren

Der Check-Tab holt eine bestehende llms.txt von einer beliebigen Domain und prüft sie gegen die llmstxt.org-Spezifikation (englisch). Du gibst entweder eine Domain ein (z. B. example.com — /llms.txt wird automatisch angehängt) oder eine volle URL. Fehlt das Schema, ergänzt das Tool https://.

Standardmäßig läuft der Abruf über den serverseitigen Proxy. Optional gibt es einen Expert Mode (Umschalter im Seitenkopf), der die Datei über einen selbst betriebenen lokalen Proxy auf http://127.0.0.1:<port> holt — fortgeschritten und für den Normalbetrieb nicht nötig.

Was der Validator prüft

Die Validierung läuft clientseitig in deinem Browser und prüft die Struktur und das Format gegen die Spezifikation — sie ruft die verlinkten Seiten nicht ab und prüft nicht, ob die Links erreichbar sind. Das Ergebnis ist in drei Stufen gegliedert:

Errors (rot, blockierend) — strukturelle Pflichtverletzungen:
- leere Datei;
- fehlende H1-Überschrift (#) bzw. eine vorhandene, aber leere H1;
- fehlendes Blockquote-Summary (>);
- ein Link mit leerer URL.
Warnings (gelb, sollte behoben werden) — u. a.: mehrere H1-Überschriften; H1 nicht in der ersten Zeile; Blockquote nicht direkt nach der H1; HTML-Entities im Blockquote; leere H2-Überschrift; Link mit leerem Titel; keine H2-Sektionen vorhanden; keine Links vorhanden; sehr kurze Datei (unter 100 Bytes); sehr große Datei (über ~50 KB).
Info (Hinweise) — z. B. ein Link ohne Beschreibung („consider adding one"); außerdem die Erfolgsmeldung „File structure looks valid", wenn weder Fehler noch Warnungen auftreten.

Jede Meldung nennt die betroffene Zeilennummer. Kurz gefasst: H1-Titel, Blockquote-Tagline und nicht-leere Link-URLs sind hart Pflicht (Fehler), während Sektionen, Links und Beschreibungen dringend empfohlen sind (Warnung/Info).

Das Check-Ergebnis lesen

Oben steht ein Statusbanner mit einem Verdict-Band:

grün „Structure looks valid." — 0 Fehler und 0 Warnungen;
gelb „N warning(s) found." — keine Fehler, aber Warnungen;
rot „N error(s) found." — mindestens ein Fehler.

Darunter eine Summary-Tabelle: Titel (H1), Summary (>), Anzahl Sektionen (##), Anzahl Links und Dateigröße. Es folgen die Listen Errors / Warnings / Info (nur, wenn nicht leer) und ein einklappbarer Raw content-Block mit Zeilennummern. Von dort kannst du den Rohinhalt per Copy kopieren oder per Load into Generator direkt ins Formular übernehmen, um die Datei zu reparieren. Liefert die Domain HTTP 404 oder einen anderen Nicht-2xx-Status, meldet das Tool „No llms.txt found … (HTTP nnn)"; eine leere Antwort meldet es ebenfalls als Warnung.

Format-Referenz

Der Reference-Tab enthält die vollständige Spezifikation, die der Generator erzeugt und der Checker prüft. Die Elemente:

Element	Syntax	Pflicht	Bedeutung
Titel	`# Projektname`	Pflicht	H1 — Name des Projekts/der Website
Tagline	`> Kurzbeschreibung`	Pflicht	Blockquote direkt nach dem Titel; ein knapper Satz; das wichtigste Feld
Intro	Plaintext-Absatz	optional	Zusätzlicher Kontext, 1–3 Sätze
Sektion	`## Sektionsname`	optional	H2 zum Gruppieren von Links; 2–5 Sektionen
Subsektion	`### Subsektionsname`	optional	H3 zum Untergruppieren innerhalb einer Sektion; nach deren eigenen Links
Link	`- [Titel](URL)`	optional	Listenpunkt mit Markdown-Link, innerhalb einer Sektion
Link-Beschreibung	`- [Titel](URL): Beschr.`	optional	Beschreibung nach dem Doppelpunkt; für jeden Link empfohlen
llms-full.txt	`- [llms-full.txt](URL)`	optional	Verweis auf die kombinierte Vollversion; per Konvention in „Optional"

Ein vollständiges Beispiel (Komplettformat) und eine kopierbare Vorlage liegen ebenfalls im Reference-Tab.

llms-full.txt — die kombinierte Inhaltsdatei

llms-full.txt enthält den zusammengeführten Textinhalt aller in der llms.txt verlinkten Seiten in einer einzigen großen Datei. Nützlich für LLM-Clients, die große Kontextfenster in einem Request verarbeiten, viele Einzel-HTTP-Requests vermeiden oder einen gecachten/Offline-Snapshot deiner Doku brauchen. Für große Doku-Sites empfiehlt das Tool, die llms-full.txt per Build-Script in der CI/CD-Pipeline automatisch zu erzeugen.

Limits, Architektur und Datenschutz

Generator: rein clientseitig. Die Datei wird vollständig in deinem Browser zusammengebaut; nichts wird übertragen. Dein Zwischenstand liegt im LocalStorage.
Check: serverseitiger Proxy. Dein Browser darf eine fremde llms.txt wegen CORS nicht direkt laden. Ein serverseitiger JPKCom-Proxy holt sie per cURL und gibt sie zurück; validiert wird dann wieder lokal in deinem Browser. Die geprüfte Domain sieht den Request vom JPKCom-Server (mit dessen User-Agent), nicht deine IP-Adresse.
SSRF-Schutz: Der Proxy blockiert localhost-, interne, private und reservierte IP-Adressen und prüft jeden Redirect-Hop erneut; nur HTTP und HTTPS sind erlaubt. Eine lokale Dev- oder Intranet-Datei lässt sich so nicht prüfen.
Abruf-Grenzen: Body-Limit 1 MB, Timeout 10 s, maximal 5 Redirect-Hops.
Rate-Limit (clientseitig): Zwischen zwei Checks liegen mindestens ~3 Sekunden (im Expert Mode umgangen). Feuerst du schneller, bittet das Tool dich kurz zu warten.
Kein öffentliches API: Die beiden serverseitigen Endpunkte (Fetch-Proxy und ein token-basierter Authentifizierungs-Endpunkt) werden ausschließlich vom JavaScript des Tools genutzt und sind gegen Missbrauch gehärtet — sie sind nicht dafür gedacht, von außen aufgerufen zu werden.

Für den Einstieg und das große Bild siehe die Übersichtsseite, für konkrete Durchläufe die Beispiele und für Strategie die Tipps & Tricks. Ausprobieren kannst du alles direkt im Tool.