Markdown zu HTML

So funktioniert es

Schreiben Sie den Text in das linke Feld oder fügen Sie ihn dort ein; die Ausgabe entsteht beim Tippen rechts. Die Umwandlung übernimmt ein ausgereifter Markdown-Parser, deshalb erkennt das Werkzeug die gesamte alltägliche Schreibweise: Überschriften von eins bis sechs, fett und kursiv, durchgestrichen, Code im Fließtext und eingezäunte Codeblöcke, verschachtelte Listen, Aufgabenlisten (ein Leerzeichen oder ein x in eckigen Klammern), Tabellen, Zitate, Bilder, Trennlinien und ausgeschriebene Adressen. Steht in Ihrem Text bereits HTML, bleibt es HTML — allerdings erst nach einem Sicherheitsfilter, der Skript-Elemente, Ereignisattribute und Adressen entfernt, die beim Anklicken Code ausführen. Die Ergebniszeile zählt, was gefunden wurde, und nennt die Zahl der entfernten Elemente. Zwei Ausgabeformen stehen bereit: Rumpf-HTML fügen Sie in eine vorhandene Seite ein, die vollständige Seite ergibt eine Datei, die sich allein öffnen lässt.

Dieses Werkzeug ist auch als markdown to html, markdown in html umwandeln, md zu html konverter, markdown tabelle html, markdown vorschau bekannt.

Was ist Markdown-Zeichen?

In Markdown wird die Form nicht mit Elementen, sondern mit Satzzeichen am Zeilenanfang oder rund um den Text ausgedrückt: Die Zahl der Rauten gibt die Überschriftenebene, zwei Sternchen machen fett, eines kursiv, ein Backtick kennzeichnet Code, und eine Zeile mit einem Größer-als-Zeichen ist ein Zitat. Das ist eine Übereinkunft und kein einziger amtlicher Standard; die Verarbeiter sind sich im Kern einig und gehen im Detail auseinander.

Was ist GFM (GitHub Flavored Markdown)?

GFM ist die meistverbreitete Markdown-Mundart und ergänzt die Grundschreibweise um vier Dinge: Tabellen mit senkrechten Strichen, Aufgabenlisten in eckigen Klammern, durchgestrichenen Text zwischen doppelten Tilden und das selbsttätige Verlinken einer im Satz ausgeschriebenen Adresse. Der größte Teil des heute geschriebenen Markdowns ist in dieser Mundart verfasst, und dieses Werkzeug erkennt sie.

Was ist HTML-Bereinigung (Sanitisierung)?

HTML zu bereinigen heißt, aus einem Fragment die gefährlichen Teile zu entfernen, bevor es auf eine Seite kommt: Skript-Elemente, an Klick- oder Ladeereignisse gehängte Attribute, Elemente, die fremde Seiten in einen Rahmen holen, und Code ausführende Adressen fallen weg, die übrige Struktur bleibt. Der Unterschied zum Maskieren ist entscheidend: Maskieren macht aus allem Text, Bereinigen lässt sichere Elemente Elemente sein.

Was ist Rumpf-HTML?

Rumpf-HTML sind die Elemente, die allein den Inhaltsteil einer Seite bilden: Überschriften, Absätze, Listen, Links. Die Doctype-Angabe, der Kopfbereich, der Zeichensatz und die Verweise auf Stildateien liegen außerhalb dieses Fragments, denn sie gehören zum Gerüst der Seite. Text für ein Redaktionssystem, eine E-Mail-Vorlage oder einen Blog-Editor wird meist genau in dieser Form verlangt.

Worin unterscheiden sich Markdown und HTML?

Beide leisten dasselbe — sie geben Text eine Struktur — wenden sich aber an verschiedene Seiten. Markdown schaut auf den Menschen: Es liest sich auch unverarbeitet gut, ist schnell geschrieben und bleibt in der Versionsgeschichte übersichtlich. HTML schaut auf den Browser: Jedes Element ist ein ausdrückliches Tag, nimmt Attribute an und verschachtelt sich unbegrenzt. Genau deshalb funktioniert Markdown fast überall; irgendwann wird es in HTML umgewandelt. Dieses Werkzeug erledigt diesen letzten Schritt, ohne einen Server zu berühren.

Welche Markdown-Schreibweise wird erkannt?

Die CommonMark-Grundlage und dazu die GitHub-Ergänzungen, die sich überall durchgesetzt haben. Die folgende Liste sammelt das, was tatsächlich benutzt wird; was nicht darin steht, erscheint als einfacher Text und verschwindet nicht stillschweigend.

Einzelne Zeilenumbrüche trennen bewusst keinen Absatz: Zeilen, die Sie untereinander schreiben, bleiben ein Absatz, und eine Leerzeile beginnt einen neuen. Deshalb zerfällt Text, den Sie aus einer E-Mail oder einer Notiz-App einfügen, nicht in Bruchstücke.

• Überschriften, fett, kursiv, durchgestrichen (~~so~~)
• Code im Fließtext und Codeblöcke mit Sprachangabe
• Verschachtelte Aufzählungen und nummerierte Listen; Aufgabenlisten
• Tabellen mit senkrechten Strichen samt Ausrichtungszeile
• Zitate, Trennlinien, Bilder, Links
• Eine im Text ausgeschriebene Adresse wird von selbst anklickbar

Was geschieht mit dem HTML in Ihrem Text?

Markdown erlaubt von sich aus HTML zwischen den Absätzen; ein Aufklappkasten (details), eine Tastenangabe (kbd) oder eine von Hand gebaute Tabelle entsteht meist auf diesem Weg. Dieses Werkzeug behält sie, schickt sie aber zuerst durch einen ausgereiften Reiniger.

Der Filter entfernt alles, womit der Browser Code ausführen könnte: Skript-Elemente, Elemente, die fremde Seiten in einen Rahmen holen, Attribute für Klick- und Ladeereignisse sowie Adressen, die Code starten. Zwei weitere Elemente fallen absichtlich weg: der Stilblock und das Formular. Rumpf-HTML wird in eine fremde Seite eingefügt, und ein dorthin gelangter Stilblock färbt die ganze Seite um, während ein Formular zu einem falschen Anmeldefeld werden kann.

Wurde etwas entfernt, nennt die Ergebniszeile die Anzahl der bereinigten Elemente. So erfahren Sie auch ohne zeilenweisen Vergleich, dass etwas aus Ihrem Text verschwunden ist.

Wie werden Linkadressen gefiltert?

Geprüft wird das Schema am Anfang der Adresse, also der Teil vor dem Doppelpunkt. Web-, E-Mail-, Telefon-, Kurznachrichten- und Dateiserveradressen kommen durch; Adressen, die beim Anklicken Code ausführen, fallen still weg, und der Link bleibt ohne Ziel.

Relative Adressen sind bewusst erlaubt: ein Pfad mit Schrägstrich am Anfang, ein Dateiname im selben Ordner oder ein Sprungziel innerhalb der Seite gelten als gültig. Wenn Sie die Ausgabe in Ihre eigene Website einfügen, brauchen Sie genau das.

Haben Sie einem Link selbst ein Ziel mitgegeben (etwa: in einem neuen Tab öffnen), bleibt auch das erhalten; aktuelle Browser öffnen solche Links ohnehin abgeschottet.

Rumpf-HTML oder vollständige Seite?

Die Rumpfausgabe liefert nur die Inhaltselemente: Das fügen Sie in eine bestehende Vorlage, ein Redaktionssystem oder den Text einer E-Mail ein.

Die Option für die vollständige Seite erzeugt eine lauffähige HTML-Datei mit Doctype-Angabe, Sprachattribut, Zeichensatz und Viewport-Angabe. Der Seitentitel stammt aus der ersten Überschrift erster Ebene; fehlt sie, wird ein allgemeiner Name eingesetzt.

Häufige Fragen

Bleiben die HTML-Elemente in meinem Text erhalten?

Ja, aber nur gefiltert. Aufklappkästen, Tastenangaben oder Tabellen, die Sie selbst geschrieben haben, bleiben als Elemente erhalten; Skripte, Rahmen, Ereignisattribute und Code ausführende Adressen fallen weg. Die Anzahl der entfernten Elemente steht in der Ergebniszeile.

Werden auch Tabellen umgewandelt?

Ja. Mit senkrechten Strichen gezeichnete Tabellen werden samt Kopf- und Ausrichtungszeile zu echten Tabellenelementen. Liegen Ihre Daten noch als CSV-Datei vor, spart der Umweg über das Werkzeug CSV zu Markdown-Tabelle einen Arbeitsschritt.

Bleiben verschachtelte Listen erhalten?

Ja. Solange Sie die Unterpunkte einrücken, bleibt die Tiefe erhalten; zwei oder vier Leerzeichen Einrückung genügen. Punkte einer Aufgabenliste erscheinen als angehaktes oder leeres Kästchen.

Können Zeichen im Codeblock kaputtgehen?

Nein. Im Codeblock und im Code des Fließtextes wird nichts formatiert, und spitze Klammern werden innerhalb des Code-Elements zu Text, erscheinen also genau wie eingegeben. Schreiben Sie hinter den öffnenden Zaun eine Sprachangabe, erhält das Ausgabeelement die Klasse dieser Sprache.

Wird mein Text irgendwohin gesendet?

Nein. Umwandlung und Sicherheitsfilter erledigen zwei Bibliotheken, die in Ihrem Browser laufen; der eingefügte Text erreicht keinen Server.