Maschinelle Leser
Was ein Modell bekommt — llms.txt, das rohe Markdown jeder Seite und ein echter MCP-Server.
Dokumentation wird von Modellen ebenso gelesen wie von Menschen, und alle vier Antworten unten werden aus denselben Collections erzeugt, aus denen die Seiten rendern — keine von ihnen kann also von dem abweichen, was veröffentlicht ist.
| Pfad | Was es ist |
|---|---|
/llms.txt | Ein Index: Seitenname, Zusammenfassung, dann jede Seite als Link-Eintrag |
/llms-full.txt | Dieselben Seiten, vollständig, zu einer Markdown-Datei verkettet |
<seite>.md | Der Markdown-Quelltext jeder Seite |
/mcp | Ein MCP-Server — list_pages, search_docs, read_page |
Markdown, nicht HTML
Alles hier übergibt das Markdown so, wie es geschrieben wurde — deshalb bittet
das Collection-Schema Content darum, rawbody zu speichern. Ein Modell, dem man
gerendertes HTML gibt, muss ein Layout rückgängig machen, um eine Überschrift zu
finden; eines, dem man die Quelle gibt, liest, was der Autor geschrieben hat,
mit Code-Fences, die noch Fences sind, und einem MDC-Block, der noch ein
Komponentenaufruf ist.
<seite>.md wird von einer Middleware ausgeliefert statt von einer Route,
denn .md ist ein Suffix am letzten Pfadsegment und kein eigenes Segment — es
gibt kein Nitro-Routenmuster, das „jeder Pfad, der auf .md endet“ bedeutet.
Warum beide llms-Dateien
Die Konvention von llmstxt.org benennt zwei, und sie beantworten verschiedene Fragen: Ein Modell, das den Index gelesen hat, muss immer noch sechzig Seiten abrufen, und ein Modell, dem man die vollständige Datei gibt, hat sie bereits gelesen. Welche billiger ist, hängt von der Frage ab — die Seite veröffentlicht deshalb beide.
Warum ein echter MCP-Server
/mcp spricht das Protokoll über das offizielle SDK, statt ein JSON-Endpunkt
nach duxts eigenem Entwurf zu sein. Ein Client verbindet sich damit so wie mit
allem anderen, statt dass jemand einen Adapter um eine Form herum schreibt, die
nur dieses Theme hat.
Seine Suche ist ein LIKE über Titel und Beschreibungen, nicht der Index, den
der Browser nutzt: Der wird clientseitig aus dem Collection-Abzug gebaut, und
ein Server-Werkzeug hat die Datenbank selbst.