← Ghiduri

text/markdown pentru agenții AI: o versiune curată a paginii

Actualizat 2026-08-03

Ce vede un agent AI în locul produsului tău

Când un agent AI deschide o pagină de produs, nu vede layoutul frumos. Primește tot HTML-ul: antetul, mega-meniul, bannerul de cookie-uri, caruselul „clienții au mai cumpărat”, un footer cu patruzeci de linkuri și zece scripturi inline. Cele două sute de cuvinte utile despre produs se pierd în sute de kilobytes de markup. Modelul își consumă fereastra de context pe zgomot și s-ar putea să nu găsească deloc prețul sau disponibilitatea.

text/markdown rezolvă asta direct: îi dai agentului o versiune text curată a aceleiași pagini — titlu, descriere, preț, disponibilitate, condiții de livrare — fără niciun tag de meniu și fără scripturi.

De ce markdown curat bate HTML-ul

Boții sunt de două feluri. Cei care execută JavaScript se comportă ca oamenii într-un browser. Cei care nu execută — crawlere precum GPTBot, ClaudeBot sau PerplexityBot — iau ce livrează serverul imediat, fără randare. Pentru ei, toată interfața ta e zgomot, nu ajutor.

Markdown curat îți dă trei lucruri:

• Densitate de sens. Pentru un produs, în loc de 300 KB de HTML, agentul primește câțiva kilobytes de text. Citește esența, nu layoutul.
• Structură fără ambiguități. Titlurile, listele și un tabel de caracteristici se parsează mult mai sigur decât o supă de <div>-uri cu clase.
• Zero scripturi și popup-uri. Nimic de stricat la randare, nimic de sărit.

În auditul Botmetria, markdown e o categorie separată care valorează 20% — la fel de mult ca descoperirea site-ului și mai mult decât logistica sau igiena. E și cea mai ușor de ridicat de la zero, fiindcă aproape nimeni nu o oferă încă.

Cum funcționează: content negotiation

Mecanismul se numește content negotiation (negocierea conținutului). Agentul trimite în cerere un antet:

GET /product/nachos-crunch HTTP/1.1
Accept: text/markdown

Serverul vede Accept: text/markdown și, în loc de HTML, livrează markdown cu antetul Content-Type: text/markdown. Același URL — altă reprezentare. Un browser obișnuit cere text/html și primește pagina normală. Nu e cloaking: conținutul e același, diferă doar formatul.

A doua metodă e mai simplă — oglinzile .md. Lângă /product/nachos-crunch stă /product/nachos-crunch.md cu același conținut în markdown. O astfel de oglindă e ușor de deschis în browser, de verificat cu ochiul și de indicat printr-un link în llms.txt.

Ideal le faci pe amândouă: negocierea pentru agenții care știu să trimită Accept și oglinda .md ca variantă de rezervă.

Livrăm markdown noi înșine — și ținem 100/100

Regula e simplă: nu recomanda ce nu faci tu însuți. botmetria.com livrează text/markdown prin content negotiation pe paginile proprii. Iar în chiar auditul nostru, categoria markdown (aceleași 20%) ne arată 100/100. E o dovadă de tip dogfood — mecanismul funcționează, trăim pe el noi înșine.

Pentru context: pe cele 63 de magazine din Moldova și România, mediana AI-readiness e doar 38 din 100 — zona roșie (≤40). markdown e una dintre cele mai subevaluate categorii din tabloul ăsta: a livra text curat e mai ieftin decât a rescrie toată logistica sau a repara viteza.

Cum îl activezi în 20 de minute

Pe WooCommerce cel mai simplu e prin pluginul Botmetria: construiește versiunea markdown a fiecărei fișe de produs și configurează automat și negocierea, și oglinda .md, din aceleași date care există deja în produs.

Pe un site custom adaugă un endpoint sau un snippet care livrează markdown pentru fiecare fișă:

1. Compune textul: # Titlu, un paragraf de descriere, rândurile Preț, Disponibilitate, Livrare/retur.
2. Livrează-l la Accept: text/markdown și la adresa cu sufix .md.
3. Pune antetul Content-Type: text/markdown; charset=utf-8.

Iată ce ar trebui să primească agentul:

# Nachos Crunch 200 g
Chipsuri de porumb cu sare de mare.

**Preț:** 39 MDL
**Disponibilitate:** în stoc
**Livrare:** 1–2 zile în Chișinău, retur 14 zile

Același preț și aceeași disponibilitate merită dublate în JSON-LD Product: markdown-ul e citit de agent ca text, iar structura — ca date pentru mașini. Împreună acoperă subiectul sigur.

Cum verifici

• Deschide oglinda .md în browser — trebuie să fie text curat, fără antet și meniu.
• Verifică negocierea din terminal: curl -H "Accept: text/markdown" https://site-ul-tău/product/.... În răspuns așteaptă Content-Type: text/markdown, nu text/html.
• Rulează auditul gratuit Botmetria — categoria markdown arată scorul și exact ce e de reparat. Compară-te cu piața în clasament.

Greșeli frecvente

• Redenumești HTML-ul în .md. Înăuntru e tot HTML-ul de dinainte — fără folos. Markdown-ul trebuie să fie text real.
• Conținut diferit în HTML și markdown. Dacă prețul din markdown a rămas în urmă față de pagină, agentul va spune unul greșit. Sursa de date trebuie să fie una singură.
• Uiți Content-Type. Fără antetul corect, agentul nu înțelege că are markdown în față și tratează răspunsul ca text obișnuit sau HTML.
• Blochezi boții cărora le livrezi markdown. Să-i dai GPTBot markdown și în același timp să-l tai în robots.txt e o contradicție. Pe Googlebot/Bingbot clasici nu-i atinge niciodată.

Întrebări frecvente