In diesem Artikel
Was ist Markdown-Validierung?
Die Markdown-Validierung prüft, ob dein Dokument die richtige Syntax einhält und auf verschiedenen Plattformen korrekt dargestellt wird. Markdown ist zwar bewusst einfach gehalten, doch die Unterschiede zwischen den Parsern führen dazu, dass subtile Formatierungsfehler auf GitHub, GitLab und in anderen Tools zu unterschiedlichen Ergebnissen führen können.
Dokumentationen, README-Dateien und technische Anleitungen werden immer häufiger in Markdown geschrieben. Die Validierung sorgt für eine einheitliche Darstellung, eine saubere Überschriftenstruktur und eine klare Formatierung – unabhängig davon, wo der Inhalt angezeigt wird.
So funktioniert der Markdown-Validator
Der Markdown-Validator von CheckTown analysiert deinen Inhalt und prüft ihn auf Formatierungsfehler und strukturelle Probleme.
- Syntaxprüfung – kontrolliert Überschriftenebenen, Listenformatierung, Code-Block-Begrenzungen und Link-Syntax
- Strukturanalyse – erkennt Probleme in der Überschriftenhierarchie, etwa das Überspringen von Ebenen
- Link-Prüfung – validiert die Syntax von Inline- und Referenzlinks mit passenden eckigen und runden Klammern
Kostenlos testen – keine Registrierung erforderlich
Markdown validieren →Häufige Markdown-Fehler
Markdown-Fehler sind tückisch, weil sie keine Fehlermeldung erzeugen – der Inhalt wird einfach falsch dargestellt.
- Fehlende Leerzeilen – Markdown benötigt Leerzeilen vor Überschriften, Listen und Code-Blöcken, damit sie korrekt geparst werden
- Uneinheitliche Listenzeichen – das Mischen von Sternchen, Bindestrichen und Pluszeichen in derselben Liste kann Parser verwirren
- Fehlerhafte Link-Syntax – eine fehlende schließende Klammer verwandelt einen Link in reinen Text
Wann sollte man Markdown validieren?
Die Markdown-Validierung ist besonders wertvoll, wenn Dokumente auf mehreren Plattformen korrekt dargestellt werden müssen.
- Dokumentation – validiere README-Dateien vor dem Push, um die korrekte Darstellung auf GitHub sicherzustellen
- Blog-Inhalte – prüfe Markdown-Beiträge vor der Veröffentlichung, um Formatierungsprobleme frühzeitig zu erkennen
- Team-Standards – setze über CI-Pipelines einen einheitlichen Markdown-Stil bei allen Mitwirkenden durch
Häufig gestellte Fragen
Welche Markdown-Spezifikation verwendet der Validator?
Der Validator folgt der CommonMark-Spezifikation, die von GitHub, GitLab und den meisten modernen Parsern unterstützt wird.
Unterstützt der Validator GitHub Flavored Markdown?
Ja. Der Validator erkennt GFM-Erweiterungen wie Tabellen, Aufgabenlisten, Durchstreichungen und eingezäunte Code-Blöcke.
Kann die Markdown-Validierung defekte Links erkennen?
Der Validator prüft die Link-Syntax, überprüft aber nicht, ob die URLs tatsächlich erreichbar sind. Dafür ist ein spezieller Link-Checker erforderlich.