HTML in Markdown umwandeln

So funktioniert es

Sie übertragen einen alten Blogartikel, eine Wiki-Seite oder einen E-Mail-Newsletter an einen Ort, der mit Markdown arbeitet: GitHub, Notion, Obsidian oder ein Generator für statische Seiten. Fügen Sie das HTML links ein; rechts entsteht das Markdown. Aus <h2>Schritte</h2> wird zum Beispiel ## Schritte, aus <strong>5 Minuten</strong> wird **5 Minuten**, eine verschachtelte Liste behält ihre Einrückung, und eine Tabelle erscheint als GFM-Tabelle mit senkrechten Strichen. Nennt die Klasse eines Codeblocks eine Sprache (language-bash), steht sie hinter dem Zaun. Skript- und Stilblöcke werden entfernt; alles, was nur das Aussehen betrifft, hat in Markdown keine Form und entfällt, der Text bleibt. Die Ergebniszeile zählt Überschriften, Listen, Tabellen, Links und entfernte Blöcke.

Dieses Werkzeug ist auch als html in markdown umwandeln, html zu markdown konvertieren, html to markdown, webseite in markdown umwandeln, html in md bekannt.

Was ist Markdown?

Markdown ist eine Schreibweise für reinen Text, in der Satzzeichen die Formatierung angeben: Eine Raute am Zeilenanfang macht eine Überschrift, doppelte Sternchen machen fett, ein Bindestrich beginnt einen Listenpunkt. Die Datei ist auch ohne Darstellung gut lesbar; deshalb nutzen README-Dateien, Notiz-Apps und Dokumentationsseiten Markdown.

Was ist GFM-Tabelle?

Eine GFM-Tabelle (GitHub Flavored Markdown) trennt Spalten mit senkrechten Strichen und setzt unter die Kopfzeile eine Zeile aus Bindestrichen. Das ursprüngliche Markdown kennt keine Tabellen; diese Erweiterung hat sich über GitHub verbreitet und wird heute von den meisten Markdown-Programmen verstanden. Verbundene und mehrzeilige Zellen gibt es nicht.

Was ist der Unterschied zwischen HTML und Markdown?

HTML beschreibt dem Browser jede Einzelheit einer Seite: Struktur, Aussehen und Verhalten. Markdown trägt nur die Struktur und ist für Menschen zum Lesen gedacht. Beim Umwandeln von HTML in Markdown bleiben Überschriften, Listen, Tabellen, Links und Hervorhebungen erhalten; Farben, Schriften und Layout gehen verloren. Das ist Absicht: Markdown-Text sieht überall gleich aus und lässt sich leicht bearbeiten.

Was Markdown nicht abbilden kann

Markdown beschreibt nur einen kleinen Teil von HTML. Farbe, Schriftgröße, Ausrichtung und Spaltenlayout haben darin keinen Platz; sie entfallen, der Text darin bleibt.

Tabellen mit verbundenen Zellen (colspan, rowspan) lassen sich nicht als GFM-Tabelle schreiben. Das Werkzeug vereinfacht eine solche Tabelle und meldet in der Ergebniszeile „Tabelle mit verbundenen Zellen wurde vereinfacht“; prüfen Sie die Tabelle in der Ausgabe.

Zeichen mit Bedeutung in Markdown (Sternchen, Unterstrich, eckige Klammern) erhalten im normalen Text einen Backslash, damit ein Wort wie datei_name nicht kursiv wird.

Welche Einstellung wann passt

Überschriften mit Raute funktionieren fast überall und sind für die Ebenen drei bis sechs die einzige Schreibweise. Unterstrichene Überschriften gibt es nur für Ebene eins und zwei; ältere README-Dateien und manche Dokumentationswerkzeuge bevorzugen sie. Ab Ebene drei bleibt es auch in dieser Einstellung bei der Raute.

Eine Referenzliste hält lange Texte mit vielen Links lesbar: Im Text steht nur [Seite][1], die Adressen stehen gesammelt am Ende. Bei kurzen Texten sind Links im Text einfacher.

Häufige Fragen

Kann ich eine komplette Webseite einfügen?

Ja. Der head-Bereich, Skripte und Stile entfallen, der Inhalt des body wird umgewandelt. Menü, Fußzeile und Seitenleiste landen aber als Text in der Ausgabe; wenn Sie nur den Artikel brauchen, kopieren Sie nur diesen Teil aus dem Quelltext.

Was passiert mit Bildern?

Jedes Bild wird zu einer Zeile ; das Bild selbst wird nicht heruntergeladen, nur seine Adresse notiert. In die Seite eingebettete Bilder (Adresse beginnt mit data:) werden weggelassen, weil sie extrem lang sind.

Kann ich Markdown auch wieder in HTML umwandeln?

Ja, dafür gibt es das Werkzeug Markdown in HTML umwandeln. Beide arbeiten zusammen: Das hier erzeugte Markdown lässt sich dort wieder in HTML übersetzen.

Wird mein HTML hochgeladen?

Nein. Die Umwandlungsbibliothek läuft in Ihrem Browser; der eingefügte Code geht an keinen Server.