HTML in Markdown umwandeln: Was dabei verloren geht und warum

VeröffentlichtToolHTML in Markdown umwandeln

Inhalt
  1. Wofür Markdown ursprünglich gedacht ist
  2. Was HTML kann, die Markdown-Syntax aber nicht
  3. Warum Tabellen besonders oft kaputtgehen
  4. Was das Tool automatisch erledigt
  5. Was Sie nach der Umwandlung zuerst prüfen sollten
  6. Fazit
  7. Häufig gestellte Fragen

Wenn Sie schon einmal ein HTML-Dokument in Markdown umgewandelt haben, um es in Notion, auf GitHub oder in einem Static-Site-Projekt weiterzuverwenden, kennen Sie vermutlich diese Situation: Im Original waren in einer Tabelle zwei Zellen verbunden. Öffnen Sie das umgewandelte Markdown, ist nicht nur die Zellverbindung weg, sondern die Tabellenform insgesamt – übrig bleibt nur der Text der Zellen, Zeile für Zeile aufgelistet. Mit Textfarben ist es ähnlich: Nach der Umwandlung steht der Text ohne Farbinformation einfach in Schwarz da.

Das ist kein Zeichen für eine fehlerhafte Umwandlung. Es ist ein strukturell zwangsläufiges Ergebnis, denn das Format Markdown hat von Haus aus keine Syntax, um solche Informationen aufzunehmen.

Zusammenfassung ① Markdown ist ein einfaches Format, das nur grundlegende Dokumentformatierungen wie Fett, Kursiv, Listen und Tabellen abbildet. Für viele der ausgefeilteren HTML-Funktionen gibt es daher schlicht keine passende Syntax. ② Informationen ohne Entsprechung in Markdown – etwa verbundene Tabellenzellen, bestimmte Textfarben oder verschachtelte Inline-Stile – gehen bei der Umwandlung verloren oder werden in eine andere Form überführt. ③ Deshalb sollten Sie das Ergebnis nie ungeprüft übernehmen, sondern immer selbst nachsehen – vor allem bei Tabellen sowie bei Farben und Hervorhebungen.

Wofür Markdown ursprünglich gedacht ist

Markdown wurde so entworfen, dass sich Fließtext, den man leicht von Hand schreibt, mit nur wenigen Zeichen um die wichtigsten Formatierungen ergänzen lässt: Überschriften, Fett, Kursiv, Listen, Zitate, Links und Code. Die Zahl der Zeichen ist so gering, dass sich das gesamte Regelwerk in einer einzigen Syntaxtabelle zusammenfassen lässt.

HTML dagegen erlaubt für jedes Tag verschiedene Attribute, und kommt CSS hinzu, sind Farben, Größen oder Ausrichtungen in praktisch unbegrenzten Kombinationen möglich. Beide Formate decken von Anfang an einen unterschiedlich großen Bereich ab.

Deshalb ähnelt die Umwandlung von HTML in Markdown eher einer „Zusammenfassung" als einer „Übersetzung". Übertragen werden nur Informationen, für die es in Markdown eine Entsprechung gibt; alles andere fällt bei der Umwandlung ganz natürlich weg.

Was HTML kann, die Markdown-Syntax aber nicht

Am häufigsten fallen verbundene Tabellenzellen auf. In HTML-Tabellen kann eine Zelle mehrere Spalten (colspan) oder mehrere Zeilen (rowspan) belegen. Die Markdown-Syntax für Tabellen kennt dagegen nur ein einfaches Raster: Kopfzeile, Trennzeile (---) und die darunterliegenden Datenzeilen müssen alle dieselbe Spaltenanzahl haben. Das Konzept verbundener Zellen gibt es in der Syntax schlicht nicht.

Bei Farben und Inline-Stilen ist es genauso. In HTML lassen sich Textfarbe, Hintergrundfarbe und Schriftgröße über das Attribut style oder über Klassen frei festlegen. Markdown kennt nur ein paar Auszeichnungen wie Fett, Kursiv, Durchgestrichen und Inline-Code – eine Syntax für Farbe oder Größe gibt es überhaupt nicht.

Ähnlich verhält es sich bei der Option „Überschriftenstil" in diesem Tool. Die Setext-Variante, bei der Überschriften mit Unterstreichung markiert werden, kennt in der Markdown-Syntax nur genau zwei Ebenen: Ebene 1 (=) und Ebene 2 (-). Enthält das ursprüngliche HTML Überschriften ab der dritten Ebene (h3 bis h6), werden diese Abschnitte daher auch bei gewähltem Setext-Stil automatisch in der #-Schreibweise (ATX) ausgegeben. Ebenen, die sich gar nicht per Unterstreichung darstellen lassen, werden also nicht gewaltsam in eine Unterstreichung gepresst.

Warum Tabellen besonders oft kaputtgehen

Die Markdown-Tabellensyntax unterstützt lediglich linke, zentrierte und rechte Ausrichtung. Über die Position des Doppelpunkts (:) in der Trennzeile lässt sich nur die Ausrichtung festlegen; für vertikale Ausrichtung, Zellhintergrundfarben oder verbundene Zellen sieht die Syntax keinen Platz vor.

Was dieses Tool tatsächlich tut, ist sogar noch einfacher: Es baut die HTML-Tabelle nicht in eine Markdown-Tabelle mit senkrechten Strichen (|) um, sondern löst den Text jeder einzelnen Zelle der Reihe nach in Absätze auf. An der Stelle der Tabelle bleibt deshalb statt eines Zeilen-und-Spalten-Rasters nur eine Folge von Absätzen, in denen die Zellinhalte von oben nach unten aufgelistet sind. Je mehr Tabellen ein Text enthält, desto wichtiger ist es, das Ergebnis nach der Umwandlung noch einmal zu prüfen.

HTML in Markdown umwandeln

Fügen Sie HTML ein und wandeln Sie Überschriften, Fettdruck, Listen und Codeblöcke sofort in Markdown-Syntax um – das Ergebnis lässt sich direkt kopieren. Der HTML-zu-Markdown-Konverter

Was das Tool automatisch erledigt

Das Tool zur Umwandlung von HTML in Markdown übernimmt in dem Moment, in dem Sie HTML in das Eingabefeld einfügen, automatisch alle Teile, für die es in Markdown eine Entsprechung gibt (Überschriften, Fett, Links, Listen, Codeblöcke usw.). Sie müssen keine eigene Schaltfläche „Umwandeln" drücken: Sobald sich die Eingabe ändert, wird das Ergebnis sofort aktualisiert.

Auch Überschriftenstil (ATX mit # oder Setext mit Unterstreichung), Aufzählungszeichen (Bindestrich, Stern, Plus) und Codeblock-Stil (Fenced oder eingerückt) lassen sich auswählen, sodass Sie das Format an die Markdown-Konventionen des Zielorts anpassen können. Die Berechnung erfolgt in dem Moment des Einfügens ausschließlich in Ihrem Browser und wird nicht an einen Server übertragen.

Die Automatik reicht allerdings nur so weit, „das, was es in Markdown gibt, korrekt zu übertragen". Tabellen in Pipe-Syntax neu aufzubauen oder Syntax zu erfinden, die es in Markdown gar nicht gibt (Zellverbindung, Farben), kann sie nicht. An diesen Stellen müssen Sie das Ergebnis selbst ansehen und beurteilen.

Was Sie nach der Umwandlung zuerst prüfen sollten

Gab es eine Tabelle, schauen Sie sich zuerst die Reihenfolge der Zellinhalte an. Da die Tabellenform wegfällt und alles in Absätze aufgelöst wird, sollten Sie prüfen, ob die Inhalte der Zellen, die im Original in derselben Zeile standen, noch in der richtigen Reihenfolge aufeinanderfolgen – oder ob sie an eine falsche Stelle gerutscht sind und sich dadurch der Sinn verändert hat.

Auch Passagen, die durch Farbe oder Hintergrund hervorgehoben waren, sollten Sie sich noch einmal ansehen. Entscheidend ist, ob die Hervorhebung im Ergebnis wenigstens durch ein anderes Zeichen wie Fett oder Kursiv erhalten geblieben ist oder ob der Text ohne jede Markierung als gewöhnlicher Satz untergegangen ist. Wo die Hervorhebung fehlt, markieren Sie sie am Zielort am besten von Hand neu.

Fazit

  • Markdown ist ein einfaches Format, das nur grundlegende Dokumentformatierungen abbildet. Für viele ausgefeilte HTML-Funktionen gibt es deshalb keine passende Syntax.
  • HTML-Tabellen werden nicht in die Markdown-Tabellensyntax (senkrechte Striche) umgebaut, sondern in Absätze aufgelöst, in denen die Zellinhalte der Reihe nach aufgelistet sind. Bei verbundenen Zellen wird die Reihenfolge besonders leicht unübersichtlich.
  • Inline-Stile wie Text- oder Hintergrundfarbe haben in Markdown keine Syntax und gehen nach der Umwandlung einfach verloren.
  • Der Setext-Überschriftenstil kennt nur die Ebenen 1 und 2; für tiefere Überschriftenstrukturen gibt es dort keine Syntax.
  • Das Tool überträgt alle Formatierungen mit Entsprechung automatisch, kann aber keine Informationen erzeugen, für die es keine Syntax gibt. Prüfen Sie Tabellen und Hervorhebungen nach der Umwandlung deshalb selbst.
HTML in Markdown umwandeln

Fügen Sie HTML ein und wandeln Sie Überschriften, Fettdruck, Listen und Codeblöcke sofort in Markdown-Syntax um – das Ergebnis lässt sich direkt kopieren. Der HTML-zu-Markdown-Konverter

Häufig gestellte Fragen

Was passiert mit verbundenen Zellen aus HTML-Tabellen nach der Umwandlung?

Die Markdown-Tabellensyntax kennt das Konzept verbundener Zellen nicht. Außerdem baut dieses Tool die Tabelle nicht in die Markdown-Tabellensyntax (senkrechte Striche) um, sondern löst den Text jeder einzelnen Zelle der Reihe nach in Absätze auf. Deshalb geht die Tabellenform insgesamt verloren – egal, ob Zellen verbunden waren oder nicht –, und es bleiben nur Absätze mit den aufgelisteten Zellinhalten. Haben Sie HTML mit Tabellen umgewandelt, sollten Sie unbedingt prüfen, ob Reihenfolge und Sinn der Zellinhalte noch zum Original passen.

Ich hatte Text- oder Hintergrundfarben gesetzt, aber nach der Umwandlung sind sie weg. Woran liegt das?

Markdown hat von vornherein keine Syntax für Farben. Es gibt nur Auszeichnungen wie Fett, Kursiv, Durchgestrichen und Inline-Code. Informationen wie Farbe oder Schriftgröße haben bei der Umwandlung deshalb keinen Platz und gehen verloren. Ist die Hervorhebung wichtig, müssen Sie sie nach der Umwandlung mit den Markdown-Grundzeichen wie Fett oder Kursiv neu setzen.

Was passiert, wenn ich Überschriften ab Ebene 3 habe und den Stil mit Unterstreichung (Setext) wähle?

Die Setext-Variante kennt in der Markdown-Syntax nur zwei Ebenen: Ebene 1 (=) und Ebene 2 (-). Dieses Tool presst Überschriften ab der dritten Ebene (h3 bis h6) nicht in eine Unterstreichung, sondern gibt genau diese Abschnitte automatisch in der #-Schreibweise (ATX) aus. Die Überschriftenebenen bleiben also auch bei Setext erhalten; allerdings können in einem Dokument Unterstreichungen und #-Schreibweise gemischt vorkommen.

Wird das umgewandelte HTML auf einem Server gespeichert oder übertragen?

Das eingefügte HTML wird ausschließlich in Ihrem Browser umgewandelt und nicht an einen Server übertragen. Auch das entstandene Markdown erscheint nur im Ergebnisfeld auf dem Bildschirm; Sie übernehmen es über die Schaltfläche „Kopieren" in die Zwischenablage.

Dieser Artikel basiert auf unserem koreanischen Original. Koreanisches Original lesen

Ähnliche Artikel

  1. ICS-Datei: Aufbau, Öffnen und Zeitzonen im Kalender erklärtEine .ics-Datei ist reiner UTF-8-Text. So lesen Sie BEGIN:VEVENT und DTSTART, kennen die drei Zeitzonen-Schreibweisen und verstehen verschobene Ganztagstermine.
  2. JSON in Excel umwandeln: Warum Zellen leer bleibenZwei Gründe, warum beim Umwandeln von JSON in Excel Zellen leer bleiben: fehlende Schlüssel und verschachtelte Werte. So prüfen Sie das vorab im Browser.
  3. JSON und YAML im Vergleich: Einrückung und typische FehlerJSON markiert Datengrenzen mit Klammern und Kommas, YAML mit Einrückung. Unterschiede, Vorteile für Konfigurationsdateien und Parsing-Fehler durch Einrückung.
  4. Markdown Zeilenumbruch funktioniert nicht: Ursachen und LösungenWarum ein einzelnes Enter in Markdown keinen Zeilenumbruch erzeugt und wie Sie mit Leerzeile, zwei Leerzeichen am Zeilenende oder breaks-Option umbrechen.
  5. Markdown-Tabelle ausrichten: Der Doppelpunkt in der TrennzeileWarum Leerzeichen in Markdown-Tabellen nichts ausrichten: Die Doppelpunkte in der Trennzeile unter der Kopfzeile legen links, zentriert oder rechts fest.
  6. Markdown-Tabelle in CSV für Excel umwandeln – ohne FehlerWarum Markdown-Tabellen aus Notion oder GitHub in Excel zerfallen und wie Sie Trennzeile und maskierte Pipes bereinigen und als CSV korrekt übernehmen.

Passende Tools