Δεν υπάρχει έκδοση Markdown για πράκτορες AI

Σύντομη απάντηση

Σε αίτημα για τη σελίδα με Accept: text/markdown ο server έστειλε HTML, και η σελίδα δεν παραπέμπει σε αντίγραφο Markdown. Οι πράκτορες AI διαβάζουν τότε όλο το HTML, μαζί με μενού, υποσέλιδα και scripts. Μια έκδοση Markdown είναι προαιρετική: πρόκειται για νέα σύμβαση, γι' αυτό είναι P3.

agent.no_markdown · Προτεραιότητα: P3

Τι σημαίνει

Σε αίτημα με Accept: text/markdown η σελίδα απάντησε με HTML και δεν παραπέμπει σε αντίγραφο Markdown (<link rel="alternate" type="text/markdown">). Οι πράκτορες διαβάζουν τότε όλο το HTML, μαζί με μενού και scripts. Προαιρετικό: το Markdown για πράκτορες είναι νέα σύμβαση, όχι πρότυπο.

Γιατί έχει σημασία για την αναζήτηση AI

Οι πράκτορες που περιηγούνται για λογαριασμό ενός χρήστη (και τα εργαλεία που φορτώνουν σελίδες στο context ενός μοντέλου) δουλεύουν με κείμενο, όχι με διάταξη. Μια καθαρή έκδοση Markdown είναι αρκετές φορές μικρότερη από το HTML και κρατά τους τίτλους, τις λίστες και τους συνδέσμους που μετράνε. Ορισμένα CDN και frameworks απαντούν ήδη στο Accept: text/markdown με τέτοια έκδοση, και το llmstxt.org προτείνει ένα αντίγραφο .md δίπλα σε κάθε σελίδα.

Χωρίς αυτήν δεν χαλάει τίποτα: οι crawlers εξακολουθούν να διαβάζουν το HTML. Είναι μια φθηνή βελτίωση αφού διορθωθούν τα ευρήματα πρόσβασης, robots.txt και περιεχομένου.

Πώς να το διορθώσετε

  1. Διαλέξτε έναν τρόπο να σερβίρετε Markdown: απαντήστε στο Accept: text/markdown στο ίδιο URL της σελίδας ή δημοσιεύστε ένα αντίγραφο όπως /guide/index.md.
  2. Σε CDN, ενεργοποιήστε τη μετατροπή σε Markdown για πράκτορες, αν υπάρχει. Σε framework, προσθέστε middleware που επιστρέφει την έκδοση Markdown όταν η κεφαλίδα Accept ζητά text/markdown.
  3. Στείλτε Content-Type: text/markdown; charset=utf-8 και, όταν το URL είναι ίδιο με της σελίδας HTML, Vary: Accept.
  4. Συνδέστε το αντίγραφο από το head του HTML με <link rel="alternate" type="text/markdown">, ώστε να το βρίσκουν και οι πράκτορες που δεν κάνουν διαπραγμάτευση περιεχομένου.
  5. Πατήστε «Έλεγχος ξανά» στην αναφορά της σελίδας για να επιβεβαιώσετε το αποτέλεσμα.

Παράδειγμα

<!-- in <head>: where agents find the Markdown version -->
<link rel="alternate" type="text/markdown" href="/guide/index.md">

# the Markdown answer
Content-Type: text/markdown; charset=utf-8
Vary: Accept

Πώς επιβεβαιώνετε τη διόρθωση

Μετά την αλλαγή, πατήστε «Έλεγχος ξανά» στην αναφορά: θα δείτε τι διορθώθηκε και πώς άλλαξε η βαθμολογία.

Έλεγχος της σελίδας μου →

Σχετικοί οδηγοί

Όλα τα ευρήματα και πώς λειτουργεί η βαθμολογία