Git Hooks und Husky: Commits ohne gültigen MDX-Frontmatter blockieren
Veröffentlicht am 25. Oktober 2026 von David
Ich habe gerade fünf neue Artikel auf meinem Next.js-Blog veröffentlicht. Der Inhalt ist präzise, der Ansatz trifft ins Schwarze. Dennoch gerät die Google Search Console 48 Stunden später in Aufruhr. Warum? Weil ein Mitarbeiter das description-Tag im Frontmatter einer .mdx-Datei vergessen hat. Oder schlimmer: Er hat titre anstelle von title geschrieben.
Das Ergebnis? Ein leeres Title-Tag, eine stark sinkende Klickrate in den Suchergebnissen und manchmal sogar ein Absturz der Client-Komponente aufgrund eines fehlenden Datumsfelds. All das wegen eines vermeidbaren Fehlers.
Das Problem? Sich auf das menschliche Gedächtnis für technisches SEO zu verlassen, ist wie russisches Roulette mit Ihrem organischen Traffic zu spielen. Die Notion-Richtlinien? Sie verstauben. Die einzige radikale Lösung, um Ihre Kundenakquise zu schützen, ist die Einschränkung: Den Fehler blockieren, bevor er den Computer Ihres Teams verlässt.
Der Pre-Commit-Hook: Ihr SEO-Schutzmechanismus
Im B2B-Bereich hängt der organische Traffic von einer fehlerfreien technischen Umsetzung ab. Genauso wie das SEO Ihrer PDF-Dokumente das Überleben Ihrer Social-Media-Veröffentlichungen bestimmt, entscheidet die Struktur Ihrer MDX-Dateien über Ihre Indexierung bei Google. Eine falsch formatierte .mdx-Datei bedeutet ein leeres Title-Tag, eine sinkende Klickrate und manchmal eine abstürzende Client-Komponente.
Die Lösung? Husky. Dieses Tool ermöglicht Ihnen die Nutzung von Git Hooks ohne Reibungsverluste. Durch die Kombination von Husky mit einer Kontrolle im pre-commit-Stadium verhindern Sie physisch das Speichern eines Artikels, der gegen Ihre SEO-Regeln verstößt. Das Terminal leuchtet rot, der Commit wird abgelehnt, und der Redakteur korrigiert seinen Text in 30 Sekunden.
Ihr Projekt in 20 Minuten absichern
Ein Skript zu konfigurieren, das die Kopfzeilen Ihrer Artikel zum Zeitpunkt des Commits extrahiert und analysiert, ist eine Sache von 20 Minuten. Das Tool durchsucht die geänderten Dateien und überprüft das Vorhandensein der Pflichtfelder: Titel, Auszug, Datum, Titelbild.
Sie können sogar noch einen Schritt weitergehen und eine strikte Längenvalidierung durchführen. Wenn die Meta-Beschreibung 160 Zeichen überschreitet, bricht das Skript sofort ab. Der Commit schlägt fehl. Von nun an wird selbst dann, wenn ein vorübergehend engagierter Freelance-Entwickler ein Tag vergisst, die fehlerhafte Datei nicht in die Produktion gelangen.
Die technische Automatisierung muss der visuellen Umsetzung dienen
Ich habe die Textstruktur meines Blogs abgesichert. Hart, pragmatisch, unerbittlich.
Doch B2B-Inhalte leben nicht nur in meinen Markdown-Dateien. Um qualifizierte Leads zu gewinnen und auf LinkedIn zu dominieren, brauche ich visuelle Inhalte. Wenn ich meine Zeit mit Skripten auf der Code-Ebene schütze, werde ich sie nicht damit verschwenden, drei Stunden lang manuell Textblöcke in Figma zu verschieben. Mein kreativer Prozess braucht dieselbe Strenge wie mein Git.
Les illustrations de ce blog sont généreusement mises à disposition par les photographes d' Unsplash.