HTML in Markdown umwandeln: Anleitung, Optionen und der schnellste Weg

Wer Webinhalte für ein README, eine Dokumentation oder ein modernes Content-Management-System braucht, steht oft vor demselben Problem: Der Text liegt als HTML vor, gebraucht wird aber sauberes Markdown. Statt von Hand jede Überschrift und jeden Link umzuschreiben, übernimmt ein Konverter die Arbeit in Sekunden. Dieser Ratgeber zeigt den schnellsten Weg, erklärt jede Option und sagt ehrlich, wo die Grenzen liegen.

Der typische Anlass ist Wiederverwendung. Sie haben einen Artikel, eine Produktbeschreibung oder eine Hilfeseite, die als HTML existiert, und möchten denselben Inhalt an einer anderen Stelle einsetzen, an der nur Markdown akzeptiert wird. HTML von Hand zurückzubauen ist mühsam und fehleranfällig: Schließende Tags werden vergessen, Verschachtelungen geraten durcheinander, und am Ende stimmt die Struktur nicht. Ein Konverter geht den umgekehrten Weg zuverlässig und reproduzierbar. Er liest die HTML-Struktur ein, erkennt Überschriften, Absätze, Listen, Links und Hervorhebungen und schreibt dafür die passende Markdown-Entsprechung. Genau deshalb ist die maschinelle Umwandlung der Handarbeit fast immer überlegen, sobald der Text mehr als ein paar Zeilen umfasst.

Schritt für Schritt mit dem Tool

Der Konverter auf html-md.de besteht aus zwei Feldern nebeneinander: links der HTML-Eingang, rechts das Markdown-Ergebnis. So gehen Sie vor:

• HTML einfügen oder Datei laden: Kopieren Sie den HTML-Quelltext in das linke Feld oder ziehen Sie eine .html-Datei hinein. Das Markdown erscheint sofort, ohne Klick auf einen Knopf.
• Optionen wählen: Über die Schalter stellen Sie ein, wie das Ergebnis aussehen soll, etwa welcher Listen-Marker genutzt wird oder ob GitHub Flavored Markdown aktiv ist.
• Kopieren oder herunterladen: Mit einem Klick übernehmen Sie das Ergebnis in die Zwischenablage oder speichern es als .md-Datei auf Ihrem Gerät.

Weil das Ergebnis live entsteht, eignet sich das Tool auch zum Experimentieren. Ändern Sie eine Option und sehen Sie sofort, wie sich das Markdown verändert. Wer viel umwandelt, entwickelt schnell ein Gefühl dafür, welche Einstellungen zum eigenen Zielsystem passen. Sollte das HTML aus der Zwischenablage einer Webseite stammen, lohnt es sich, vorher kurz zu prüfen, ob wirklich nur der gewünschte Abschnitt kopiert wurde, denn moderne Seiten betten oft unsichtbare Hilfselemente ein.

Aus diesem HTML:

<h1>Überschrift</h1>
<p>Ein <strong>kurzer</strong> Absatz mit einem
<a href="https://example.com">Link</a>.</p>
<ul>
  <li>Erster Punkt</li>
  <li>Zweiter Punkt</li>
</ul>

wird dieses Markdown:

# Überschrift

Ein **kurzer** Absatz mit einem [Link](https://example.com).

- Erster Punkt
- Zweiter Punkt

Die wichtigsten Optionen erklärt

Markdown ist nicht völlig einheitlich: Für dieselbe Struktur gibt es oft mehrere gültige Schreibweisen. Der Konverter setzt im Hintergrund die bewährte Bibliothek Turndown ein und lässt Sie zwischen diesen Varianten wählen. Die folgende Tabelle fasst die wichtigsten Schalter zusammen.

ATX-Überschriften sehen so aus:

# Überschrift Ebene 1
## Überschrift Ebene 2

Setext-Überschriften dagegen unterstreichen die Zeile, funktionieren aber nur für die ersten beiden Ebenen:

Überschrift Ebene 1
===================

Überschrift Ebene 2
-------------------

Beim Listen-Marker ist der Unterschied rein optisch: Ob ein Punkt mit Bindestrich, Stern oder Plus beginnt, ändert das gerenderte Ergebnis nicht. Der Bindestrich gilt als am besten lesbar. Bei den Code-Blöcken sind eingezäunte Blöcke klar zu bevorzugen, weil sie eine Sprachangabe für die Syntaxhervorhebung erlauben, etwa nach den drei Backticks ein js oder python.

Warum gibt es diese Optionen überhaupt? Markdown wurde nie als ein einziger, streng festgelegter Standard geboren. Verschiedene Werkzeuge haben über die Jahre eigene Vorlieben entwickelt, und manche Zielsysteme erwarten eine bestimmte Schreibweise. Ein Linter in einem Software-Projekt akzeptiert vielleicht nur den Bindestrich als Listen-Marker und meldet alles andere als Fehler. Andere Doku-Generatoren bestehen auf eingezäunten Code-Blöcken. Wer das Zielsystem kennt, stellt die Optionen einmal passend ein und muss sich danach nicht mehr darum kümmern. Im Zweifel sind die Standardwerte ATX-Überschriften, Bindestrich-Listen und eingezäunte Code-Blöcke die sicherste Wahl, weil sie am breitesten unterstützt werden.

Was passiert mit Skripten, Styles und CSS?

Hier liegt der wichtigste Unterschied zwischen HTML und Markdown: HTML beschreibt Struktur und Aussehen, Markdown beschreibt nur die Struktur. Inhalte aus <script> und <style>, eingebundene Stylesheets über <link> sowie Inline-CSS in style-Attributen haben in Markdown schlicht keine Entsprechung. Der Konverter verwirft sie deshalb bewusst.

Das ist richtig so und kein Verlust im negativen Sinn. Ziel der Umwandlung ist ein sauberer, portabler Inhalt, der auf jeder Plattform gleich aussieht. Würde der Konverter Inline-Styles mitschleppen, entstünde ein unleserliches Gemisch aus Markdown und HTML. Übrig bleibt der reine Inhalt: Überschriften, Absätze, Listen, Links und Bilder. Wer das HTML zuvor noch entrümpeln möchte, findet im Ratgeber HTML bereinigen zu Markdown die passenden Hinweise.

Der GFM-Schalter: Tabellen, Strikethrough, Task-Listen

GitHub Flavored Markdown, kurz GFM, erweitert den Grundumfang um Funktionen, die im Alltag oft gebraucht werden. Ist der GFM-Schalter aktiv, beherrscht der Konverter zusätzlich:

• Tabellen: Aus einer HTML-Tabelle wird eine Markdown-Tabelle mit senkrechten Strichen. Mehr dazu im Ratgeber HTML-Tabelle in Markdown umwandeln.
• Durchgestrichener Text: Aus <del> oder <s> wird Text zwischen zwei Tilden.
• Task-Listen: Aus Checkboxen werden abhakbare Listenpunkte, wie man sie aus GitHub-Issues kennt.

Ohne GFM bleibt das Ergebnis im engeren CommonMark-Umfang. Was die beiden Dialekte unterscheidet, lesen Sie im Ratgeber GitHub Flavored Markdown.

Typische Anwendungsfälle

Die Umwandlung lohnt sich überall dort, wo aus formatiertem Web-Inhalt portabler Text werden soll. Häufig sind diese Fälle:

• README für ein Repository: Eine bestehende HTML-Beschreibung wird zur README.md, die GitHub oder GitLab sauber rendert. Eine Anleitung dazu gibt der Ratgeber README mit Markdown erstellen.
• Dokumentation: Statische Doku-Generatoren erwarten Markdown. Bestehende HTML-Seiten lassen sich so in das Quellformat überführen.
• Content-Management: Viele moderne CMS und Wikis speichern Inhalte als Markdown. Migrierter HTML-Inhalt wird dort sofort weiterverwendbar.
• KI-Eingabe: Sprachmodelle verarbeiten Markdown sauberer als verschachteltes HTML. Mehr im Ratgeber HTML in Markdown für ChatGPT.

Grenzen, ehrlich benannt

Ein Konverter ist gut, aber kein Wunderwerkzeug. Bei sehr unsauberem HTML, das aus Textverarbeitungen oder alten Editoren stammt, schleppt das Ergebnis manchmal leere Absätze oder unnötige Zeilenumbrüche mit. Stark verschachtelte Tabellen, also Tabellen in Tabellen, lassen sich in Markdown gar nicht abbilden, weil das Format das nicht vorsieht. Solche Stellen werden vereinfacht oder als HTML stehen gelassen.

Auch komplexe Elemente wie eingebettete Videos, Formulare oder mehrspaltige Layouts haben in Markdown keine Entsprechung. Die Faustregel: Inhalt überträgt sich zuverlässig, aufwendiges Layout nicht. Ein kurzer Blick auf das Ergebnis lohnt sich daher immer. Für die allermeisten Texte ist die Ausgabe sofort sauber weiterverwendbar.

Ein praktischer Trick für schwierige Fälle: Wandeln Sie zunächst um und entfernen Sie dann im Markdown von Hand die wenigen Reste, die der Konverter stehen gelassen hat. Das ist immer noch deutlich schneller, als alles von Grund auf neu zu schreiben. Bleibt beispielsweise eine verschachtelte Tabelle als HTML im Markdown stehen, können Sie entscheiden, ob Sie sie vereinfachen oder als HTML belassen, denn Markdown erlaubt eingebettetes HTML problemlos. So behalten Sie die volle Kontrolle und nutzen trotzdem die Geschwindigkeit der automatischen Umwandlung.

Wer regelmäßig Inhalte zwischen Systemen bewegt, sollte sich angewöhnen, das umgewandelte Markdown einmal in der Vorschau gegenzulesen. Kleine Abweichungen fallen so sofort auf und sind in Sekunden korrigiert. Für die große Mehrheit der Texte aus Blogs, Wikis und Redaktionssystemen ist genau das aber gar nicht nötig: Das Ergebnis stimmt auf Anhieb.

Häufige Fragen