SEO konfigurieren#

So verbesserst du die Sichtbarkeit deiner Seiten in Suchmaschinen durch gezielte Metadaten im Frontmatter.

Grundlegende Metadaten setzen#

Jede Seite sollte einen title und eine description haben. Das sind die wichtigsten SEO-Felder:

Tipps:

• Der title sollte das primäre Keyword enthalten und maximal 60 Zeichen lang sein.
• Die description sollte zwischen 150 und 160 Zeichen lang sein.
• Jede Seite braucht einen eindeutigen Titel — Duplikate verschlechtern das Ranking.

Primäres Keyword festlegen#

Das primäre Keyword ist der Begriff, für den eine Seite in Suchmaschinen gefunden werden soll. Beispiel: Für eine Seite über die CI/CD-Einrichtung wäre das primäre Keyword etwa „CI/CD Pipeline Dokumentation".

Das primäre Keyword sollte im title und in der description vorkommen. Sekundäre Keywords sind ergänzende Begriffe, unter denen die Seite ebenfalls gefunden werden kann.

Open-Graph-Bild hinzufügen#

Ein Open-Graph-Bild erscheint, wenn eine Seite in sozialen Netzwerken oder Messaging-Apps geteilt wird.

1. Erstelle ein Bild im Format 1200 × 630 Pixel (PNG oder JPG).
2. Lege es in deinem assets-Ordner oder Public-Verzeichnis ab, z. B. unter assets/og-image.png.
3. Füge es im Frontmatter ein:

Im Easy Mode kopierst du das Bild in den dokument/assets/-Ordner. Im Developer Mode legst du es im public/-Verzeichnis ab.

Strukturierte Daten hinzufügen#

Strukturierte Daten helfen Google, Inhalte als Rich Results anzuzeigen.

Für einen Referenz-Artikel:

Für eine Anleitungsseite:

Verfügbare Typen: Article, TechArticle, HowTo, FAQPage.

Canonical URL setzen#

Setze eine Canonical URL, wenn dieselben Inhalte unter mehreren Adressen erreichbar sind — zum Beispiel in einem mehrsprachigen Projekt:

hreflang für mehrsprachige Seiten#

Bei mehrsprachigen Projekten müssen alle Sprachversionen einer Seite aufeinander verweisen. Das passiert über seo.hreflang:

Füge diesen Block auf jeder Sprachversion der Seite ein, mit der vollständigen Liste aller Sprachvarianten.

Mehr zur Einrichtung von Mehrsprachigkeit: Mehrsprachigkeit einrichten.

Seiten von der Indexierung ausschließen#

Für Seiten wie Impressum, Datenschutzerklärung oder interne Seiten, die nicht in Suchergebnissen erscheinen sollen:

SEO-Prüfungen gezielt überspringen#

Wenn eine Seite bewusst keine Beschreibung hat (z. B. eine reine Weiterleitung):