Häufige Markdown-Fehler reproduzieren und beheben
Behebe fehlerhafte Überschriften, Aufgabenlisten und Links anhand eines Vorher-nachher-Beispiels und prüfe anschließend den Bildexport.
Auf dieser Seite
01Drei sichtbare Fehler nachstellen02Wenn dieselbe Quelle anders aussiehtEin fehlerhaftes Markdown-Dokument lässt sich oft weiterhin rendern; es zeigt nur die falsche Struktur. Nutze den Markdown-Konverter als Vorschau, während du die Ursache eingrenzt. Repariere zunächst das kleinste fehlerhafte Beispiel und übertrage die Korrektur dann ins vollständige Dokument.
Füge diese absichtlich fehlerhafte Checkliste in den Editor ein. Nach dem Überschriftenzeichen fehlt ein Leerzeichen, Listenzeichen und Checkbox sind verbunden, und die Linkadresse steht nicht in runden Klammern.
#Export check
**Status:** Ready for review
-[x] Heading checked
-[x] List spacing checked
-[ ] Final export inspected
[Open the converter]https://markdowntoimage.com/converter
Achte auf sichtbare Satzzeichen an Stellen, an denen du Struktur erwartest. Ein anderes Thema repariert diese Zeichenfolgen nicht. Die Checkliste enthält nur Beispieldaten und kann beliebig verändert werden.
- Ergänze nach dem Überschriftenzeichen ein Leerzeichen: Aus
#Exportwird# Export. Die erste Zeile kann nun als Überschrift erkannt werden. - Trenne Listenzeichen und Checkbox: Aus
-[x]wird- [x]. Zwischen Checkbox und Beschriftung muss ebenfalls ein Leerzeichen stehen. Aufgabenlisten sind eine GFM-Erweiterung, die der Renderer unterstützen muss. - Setze die Adresse in runde Klammern:
[label](URL). Eckige Klammern enthalten den sichtbaren Text, runde das Ziel. Prüfe den Link im gerenderten Dokument; seine Farbe im Bild sagt nichts über die Funktion aus.
Hier stehen die vollständige korrigierte Eingabe und ihr Bildexport:
# Export check
**Status:** Ready for review
- [x] Heading checked
- [x] List spacing checked
- [ ] Final export inspected
[Open the converter](https://markdowntoimage.com/converter)
Überschrift, Status und Aufgaben sind jetzt klar getrennt. Die letzte Aufgabe bleibt absichtlich offen: Eine ordentliche Vorschau ersetzt nicht die Kontrolle des Exports.
Ein Editor kann Erweiterungen unterstützen, die einem anderen fehlen. Die CommonMark-Spezifikation beschreibt die Kernsyntax, die GFM-Spezifikation Erweiterungen wie Aufgabenlisten und Tabellen. Halte das fehlerhafte Fragment klein genug, um Renderer direkt zu vergleichen.
Rutscht ein Unterpunkt aus seiner Liste, prüfe seine Einrückung, statt wahllos Leerzeichen im ganzen Dokument zu verteilen. Wird normaler Text plötzlich zu Code, suche weiter oben nach einem offenen Codezaun. Sollen Satzzeichen wörtlich erscheinen, verwende Inline-Code oder passende Escape-Zeichen, statt wichtige Zeichen zu löschen.
Exportiere erst, wenn die Vorschau die gewünschte Struktur zeigt. Öffne das heruntergeladene Bild und lies Überschrift, alle Aufgabenbeschriftungen und letzte Zeile. Ergänze Handlungslinks auch im Begleittext: Ein Bild besteht aus Pixeln und enthält keinen klickbaren Markdown-Link. Bewahre die Quelle auf, damit spätere Korrekturen keinen Neuaufbau erfordern.
Repariere und exportiere deine Checkliste. Weiter helfen der praktische Markdown-Leitfaden und bei Codezäunen oder Hervorhebung der Leitfaden zu Codeblöcken.