Veelvoorkomende llms.txt-fouten
Gepubliceerd:
De meeste llms.txt-problemen vallen in een handvol patronen. Hier zijn de problemen die onze validator het vaakst signaleert — en de snelle oplossing voor elk ervan.
1. Meer dan één H1
De specificatie vereist precies één titel op het hoogste niveau: # Title. Extra #-koppen maken de structuur verwarrend. Verlaag de overige naar ##-sectiekoppen.
2. Geen blockquote-samenvatting
Een blockquote van één of twee zinnen direct onder de titel is de context die een model als eerste leest. Die overslaan is de meest voorkomende misser. Voeg er een toe:
# Acme > Acme turns CSV files into charts. These links cover setup, the API, and pricing.
3. Secties zonder links (of helemaal geen secties)
Lege ##-secties voegen niets toe. Elke sectie hoort een Markdown-opsommingslijst te bevatten met links naar echte pagina's. Heb je helemaal geen secties, groepeer dan je belangrijkste pagina's onder koppen zoals ## Docs en ## Guides.
4. Kapotte links
Een bestand kan perfect opgemaakt zijn en toch verwijzen naar dode pagina's — dat verspilt het budget van een crawler en ondermijnt het vertrouwen. Elke URL moet bereikbaar zijn. Dit is de controle die de meeste tools overslaan; wij halen ze stuk voor stuk op.
5. Relatieve of http://-links
Gebruik overal absolute https://-URL's. Modellen kunnen relatieve paden zoals /docs/start mogelijk niet herleiden, en gewone http://-links komen onbetrouwbaar over en kunnen falen bij crawling die alleen HTTPS toelaat.
6. Het verkeerde contenttype
Serveer het bestand als text/plain; charset=utf-8. Geeft je server text/html terug (een veelgemaakte configuratiefout), dan behandelen sommige consumenten het niet als llms.txt.
7. Een opgeblazen, niet-gecureerd bestand
llms.txt is een gecureerde index, geen sitemap-dump. Honderden links zonder beschrijvingen verdrinken het signaal. Houd de beste pagina's, voeg achter elke link een korte : description toe en verplaats secundaire links naar een ## Optional-sectie.
Vang ze allemaal in één keer
Laat je bestand door de validator lopen — die beoordeelt de structuur, de bereikbaarheid van links en de best practices, en vertelt je precies welke van bovenstaande punten je moet oplossen. Ben je nieuw met dit format? Begin met hoe je een llms.txt-bestand maakt.