Markdown-ähnlichen Text als HTML-Vorschau anzeigen

Wofür sich die HTML-Vorschau eignet

Die Markdown-Vorschau wandelt eingegebenen Markdown-ähnlichen Text in eine formatierte HTML-Vorschau um. Sie können damit vor der weiteren Verwendung prüfen, wie Überschriften, Listen, Links, Hervorhebungen, Zitate oder Codebereiche dargestellt werden. Das Werkzeug nimmt Text optional entgegen: Wird nichts eingegeben, entsteht trotzdem eine erfolgreiche Verarbeitung mit leerer Vorschau. Für eine sinnvolle Prüfung eignet sich daher ein kurzer Ausschnitt, der genau die Schreibweisen enthält, die Sie beurteilen möchten. So lässt sich die Darstellung einzelner Elemente leichter von der Formatierung des übrigen Inhalts unterscheiden. Die Vorschau ist dabei eine Ansicht des erkannten Textmusters und keine Aussage darüber, wie jede denkbare Markdown-Variante verarbeitet wird.

Text eingeben und Darstellung prüfen

1. Öffnen Sie das Werkzeug und fügen Sie den zu prüfenden Markdown-ähnlichen Text in das vorgesehene Eingabefeld ein. Für einen ersten Test genügt etwa eine Überschrift mit einer hervorgehobenen Zeile; bei Bedarf ergänzen Sie Listen, Zitate oder Code. 2. Starten Sie die Verarbeitung über die dafür vorgesehene Steuerung. Ein leer gelassenes oder nicht ausgefülltes Feld ist zulässig und führt zu einer erfolgreichen Verarbeitung, deren Vorschau leer bleibt. 3. Sehen Sie sich die erzeugte HTML-Vorschau neben Ihrer ursprünglichen Eingabe an. Erkannt werden unter anderem Code innerhalb einer Zeile und in abgegrenzten Bereichen, Überschriften der Ebenen 1 bis 6, tabellenähnliche Zeilen, horizontale Linien, Zitate, Bilder, Links, Hervorhebungen, Durchstreichungen, Listen und ausgewählte Zeilenumbrüche. 4. Prüfen Sie anschließend die Stellen, an denen die Darstellung von Ihrer Erwartung abweicht. Vergleichen Sie dafür die verwendete Schreibweise mit den unterstützten Musterarten und testen Sie eine auffällige Passage bei Bedarf separat. Verschachtelte Listen, tabellenähnliche Anordnungen und Zeilenumbrüche verdienen besondere Aufmerksamkeit, weil die Umwandlung auf festgelegten Mustern beruht. 5. Bei einer Eingabe mit Inhalt berücksichtigen Sie zusätzlich die angezeigte Zeichenanzahl. Diese Zahl bezieht sich auf die Zeichen des ursprünglichen Textes. Vergleichen Sie sie mit Ihrer Eingabe, nicht mit der Länge der formatierten HTML-Vorschau. Ein erneuter Test mit einem kleineren Ausschnitt kann helfen, die Ursache einer unerwarteten Darstellung einzugrenzen.

Die Ausgabe sinnvoll beurteilen

Enthält die Eingabe Text, besteht das erfolgreiche Ergebnis aus einer formatierten HTML-Vorschau und der Zeichenanzahl des ursprünglichen Inhalts. Die Vorschau macht sichtbar, welche der vorgesehenen Muster in Ihrem Ausschnitt erkannt und umgesetzt wurden. Eine leere Vorschau nach dem Absenden ist dagegen bei ausgelassenem oder leerem Text das erwartete Ergebnis und bedeutet nicht, dass die Verarbeitung fehlgeschlagen ist. Weicht ein Element ab, prüfen Sie zunächst die konkrete Schreibweise und den Zusammenhang mit benachbarten Zeilen. Die genannte Auswahl an Musterarten zeigt den vorgesehenen Funktionsumfang, lässt aber keinen Rückschluss auf weitere Markdown-Regeln zu. Auch die Zeichenanzahl dient nur dem Abgleich des Ausgangstextes; aus ihr lässt sich nicht ableiten, ob die visuelle Gestaltung passend wirkt. Beurteilen Sie deshalb Inhalt und Darstellung getrennt: Zuerst kontrollieren Sie den eingegebenen Text, danach vergleichen Sie die sichtbare Vorschau mit dem gewünschten Aufbau. Für komplexe Passagen ist ein isolierter Test übersichtlicher als die Prüfung eines langen Dokuments in einem Schritt.

Praktisches Beispiel

Sie möchten vor dem Kopieren einer kurzen Einkaufsliste prüfen, ob Überschrift und Hervorhebung in der Vorschau erkannt werden.

Fügen Sie den Text mit einer Überschrift in der ersten Zeile und einer hervorgehobenen Einkaufsposition in der nächsten Zeile ein und starten Sie die Verarbeitung.

Die erfolgreiche Ausgabe enthält eine formatierte HTML-Vorschau für die Überschrift und die Hervorhebung. Zusätzlich erscheint bei diesem nicht leeren Text eine Zeichenanzahl des ursprünglichen Inhalts.

Einschränkungen

• Die aufgeführten Muster beschreiben den belegten Darstellungsumfang, nicht die Unterstützung jeder Markdown-Schreibweise.

Häufige Fehler

• Wenn Sie jede Markdown-Schreibweise als unterstützt voraussetzen, kann eine Passage anders erscheinen als erwartet. Beschränken Sie den Test zunächst auf die aufgeführten Musterarten und prüfen Sie die abweichende Stelle anschließend einzeln.

Häufige Fragen

Was passiert, wenn ich keinen Text eingebe?

Bei ausgelassenem oder leerem Text wird die Verarbeitung erfolgreich abgeschlossen, während die Vorschau leer bleibt. Erst eine Eingabe mit Inhalt liefert eine formatierte HTML-Vorschau.

Welche Markdown-Elemente kann die Vorschau darstellen?

Vorgesehene Muster gibt es unter anderem für Überschriften von Ebene 1 bis 6, Listen, Links, Bilder, Code, Zitate, Hervorhebungen, Durchstreichungen, horizontale Linien, tabellenähnliche Zeilen und ausgewählte Zeilenumbrüche. Daraus folgt nicht, dass weitere Markdown-Schreibweisen ebenfalls umgesetzt werden.

Was bedeutet die angezeigte Zeichenanzahl?

Bei nicht leerem Text bezeichnet die zusätzliche Zahl die Zeichenmenge des ursprünglichen Inhalts. Die Länge der daraus erzeugten HTML-Vorschau wird damit nicht beschrieben.