Von HTML zu Markdown
Der Konverter nutzt Turndown mit dem GFM-Plugin. Er liest das HTML und übersetzt jedes Element in seine Markdown-Entsprechung: <h1> bis <h6> werden zu Überschriften, <a> zu [Text](URL), <img> zu , <strong> und <em> zu **fett** und _kursiv_, Listen zu Aufzählungen, <pre><code> zu Codeblöcken und <blockquote> zu Zitaten. Dank GitHub-Flavored Markdown werden auch Tabellen, Durchstreichungen und Aufgabenlisten mit Checkboxen umgewandelt.
Was Markdown nicht ausdrücken kann, geht verloren: Klassen, Inline-Stile, Farben, Schriftarten und Layout-Elemente wie <div> oder <span> verschwinden, der Textinhalt bleibt. Das ist meist genau gewünscht, denn so wird aus formatiertem CMS-Inhalt reiner, portabler Text mit Struktur.
Sie steuern die Ausgabe über drei Optionen: Überschriften im ATX-Stil mit # oder im Setext-Stil mit Unterstreichung, Aufzählungszeichen - oder * und Codeblöcke mit ``` umzäunt oder eingerückt. So passt das Ergebnis zu Ihrem Static-Site-Generator oder Ihrer Dokumentation. Am besten funktioniert die Umwandlung mit dem eigentlichen Inhalt einer Seite, etwa dem Artikelbereich, statt mit dem kompletten Dokument samt Navigation, Seitenleiste und Fußzeile. Kopieren Sie also nur den Teil, den Sie brauchen, oder entfernen Sie überflüssige Bereiche nach der Umwandlung. Links bleiben mit ihrer Ziel-URL erhalten, relative Pfade werden unverändert übernommen. Wenn Sie Inhalte zu einem Static-Site-Generator umziehen, ergänzen Sie danach nur noch das Front-Matter mit Titel und Datum.
Die Umwandlung läuft vollständig in Ihrem Browser, nichts wird hochgeladen. Kostenlos konvertieren Sie eine Datei oder einen eingefügten Text und können denselben Text mit anderen Optionen erneut umwandeln. Für neue Eingaben, mehrere HTML-Dateien gleichzeitig mit ZIP-Download und ohne Werbung gibt es ToolStudio Pro, jederzeit kündbar.
So wandeln Sie HTML in Markdown um
- HTML einfügen oder eine HTML-Datei ablegen bzw. auswählen.
- Überschriftenstil wählen: # (ATX) oder Unterstreichung (Setext).
- Aufzählungszeichen (- oder *) und Stil der Codeblöcke (``` oder eingerückt) festlegen.
- Umwandlung starten.
- Markdown kopieren oder als Datei herunterladen.
Typische Anwendungsfälle
- Blogartikel aus WordPress oder einem anderen CMS zu Hugo, Jekyll oder Astro umziehen.
- Inhalte einer Webseite als Notiz in Obsidian oder Notion übernehmen.
- HTML-Dokumentation in Markdown für ein Docs-Projekt überführen.
- Eine GitHub-README aus einer bestehenden HTML-Seite erstellen.
- HTML-Tabellen in Markdown-Tabellen umwandeln.
ATX oder Setext?
ATX-Überschriften beginnen mit Rautezeichen: # Titel, ## Abschnitt bis ###### für die sechste Ebene. Setext-Überschriften stehen über einer Linie aus = (Ebene 1) oder - (Ebene 2). Setext gibt es nur für zwei Ebenen, tiefere Überschriften werden auch dann im ATX-Stil geschrieben.
ATX ist heute der verbreitete Standard und wird von nahezu jedem Werkzeug unterstützt. Setext wirkt im reinen Text eleganter, ist aber weniger eindeutig in Diffs.
Häufig gestellte Fragen
Werden Tabellen umgewandelt?
Ja, dank GitHub-Flavored Markdown werden HTML-Tabellen zu Markdown-Tabellen, ebenso Durchstreichungen und Aufgabenlisten.
Was passiert mit Klassen und Stilen?
Sie werden entfernt, weil Markdown sie nicht abbilden kann. Der Textinhalt bleibt erhalten.
Bleiben Bilder erhalten?
Bilder werden als Markdown-Bildlinks mit Alternativtext und URL übernommen. Die Bilddateien selbst werden nicht heruntergeladen.
Wird mein HTML hochgeladen?
Nein, die Umwandlung findet ausschließlich in Ihrem Browser statt.
Ist der Konverter kostenlos?
Eine Datei oder ein eingefügter Text ist kostenlos; denselben Text können Sie mit anderen Optionen erneut umwandeln. Für neue Eingaben brauchen Sie ToolStudio Pro: unbegrenzt, mehrere Dateien als ZIP, ohne Werbung, jederzeit kündbar.