Dual-Format Publishing · SEAKT Trust-Signal
Dual-Format Publishing — der geoquality.ai-Standard
Jede zitierfähige Seite auf geoquality.ai ist in zwei Formaten verfügbar: als HTML für Menschen und als Markdown für Maschinen (LLMs, Crawler, RAG-Pipelines). Beide stammen aus **derselben kanonischen Quelle** (Single Source of Truth) — identischer Inhalt, kein Cloaking, schwache ETags konsistent über beide Varianten.
Skala
Vollständiges Deep-Link-Verzeichnis: /llms-full.txt (Abschnitt 9).
Die vier Negotiation-Trigger
- URL-Suffix `.md` (höchste Priorität): `/dual-format-standard.md`
- Query-Parameter: `?format=md`
- Accept-Header: `Accept: text/markdown` (RFC-9110 q-Werte)
- Standard: HTML
Antwort-Header (RFC-konform)
Jede dual-formatige Antwort trägt folgende relevanten Header:
| Header | Bedeutung |
|---|---|
Link | kanonisches HTML, alternate text/markdown, describedby /llms.txt |
ETag | Weak-ETag aus `content_hash` — identisch über HTML+MD |
Vary | Accept, Accept-Encoding |
X-Dual-Format | v1 (Schema-Version) |
X-Dual-Format-Variant | html oder markdown |
X-Robots-Tag | index, follow (explizit indexierbar) |
Cache-Control | public, max-age=300, s-maxage=3600, stale-while-revalidate=86400 |
Warum dual-format?
- Direkt-Konsum durch LLMs ohne HTML-Parsing-Overhead (kein Cheerio/BeautifulSoup, kein Boilerplate-Stripping).
- YAML-Frontmatter pro `.md` mit `canonical_url`, `content_hash`, `last_modified`, `license` — zitierfähig auf einen Blick.
- Schwache ETags (Weak-ETag) sind über HTML und MD **identisch**, weil sie aus derselben `canonical_content`-Repräsentation abgeleitet werden — Caches deduplizieren semantisch.
- Kein Cloaking-Risiko: HTML und MD sind keine konkurrierenden Versionen, sondern zwei Render-Pfade derselben Quelle.
Diese Seite live testen
# Markdown-Variante dieser Seite
curl https://www.geoquality.ai/dual-format-standard.md
# Markdown via Query
curl "https://www.geoquality.ai/dual-format-standard?format=md"
# Markdown via Accept-Header
curl -H "Accept: text/markdown" https://www.geoquality.ai/dual-format-standard
# HTML bevorzugt (q-Wert)
curl -H "Accept: text/html;q=1.0, text/markdown;q=0.5" \
https://www.geoquality.ai/dual-format-standard
# Conditional Request mit ETag (304 wenn unverändert)
curl -H 'If-None-Match: W/"<hash>"' \
https://www.geoquality.ai/dual-format-standard.md
Häufige Fragen
Warum nicht einfach HTML mit JSON-LD?
JSON-LD ist strukturierte Metadaten — gut für Knowledge-Graph-Signale. Markdown ist der eigentliche **Content** in einer Form, die LLMs ohne Vorverarbeitung konsumieren. Beide ergänzen sich; die Site liefert beides.
Sind HTML und Markdown wirklich identisch?
Semantisch ja. Der `content_hash` im Frontmatter beweist es: er wird aus einer kanonischen, sortierten Repräsentation gebildet, die HTML und MD beide rendern. Ein Parity-Gate (Jaccard ≥ 0.92, Skript `df_semantic_parity.py`) misst die Übereinstimmung pro Seite.
Wie finde ich alle Markdown-URLs?
Drei Wege: (1) `/llms-full.txt` — Sektion 9 listet alle 172 `.md`-URLs gruppiert nach Typ. (2) `sitemap.xml` — jede zitierfähige HTML-URL hat einen `.md`-Eintrag. (3) Jede HTML-Antwort trägt einen `Link: rel="alternate"; type="text/markdown"`-Header.
Sprachen?
Markdown ist aktuell DE-only (Content-Bodies sind DE). Lokalisierte MD-URLs wie `/fr/glossar/seakt.md` antworten mit HTTP 301 auf die kanonische DE-MD-URL — HTTP-konform, kein 404. FR/IT/EN-MD folgt, sobald übersetzte Bodies existieren.