Welche HTML-Elemente sich gut übertragen lassen

Semantische Elemente mit klarer Entsprechung funktionieren meist gut: h1 bis h6 werden Überschriften, p wird Absatz, strong und em werden Hervorhebung, ul und ol werden Listen und a wird ein Markdown-Link.

Einfache Tabellen, Zitate sowie pre- und code-Bereiche können ebenfalls übernommen werden. Je stärker die Seite von CSS, JavaScript oder eigenen Komponenten abhängt, desto mehr Entscheidungen bleiben danach offen.

HTMLÜbliche Markdown-Ausgabe
`<h2>Titel</h2>``## Titel`
`<strong>Text</strong>``**Text**`
`<a href="/hilfe">Hilfe</a>``[Hilfe](/hilfe)`
`<blockquote>Hinweis</blockquote>``> Hinweis`
`<pre><code>…</code></pre>`Fenced code block

Nur article oder main übernehmen

Der Quelltext einer vollständigen Seite kann Navigation, Newsletterbox, Cookie-Banner, verwandte Beiträge, Kommentare und Fußzeile enthalten. Wenn möglich, kopiere aus dem CMS direkt das Inhaltsfeld oder im Browser den Bereich `article` beziehungsweise `main`.

Klassen und Styles müssen nicht alle vorab entfernt werden, weil Markdown kein Layout beschreibt. Unpassende Inhaltsblöcke solltest du jedoch ausschließen, da ein Konverter nicht sicher erkennt, ob „Jetzt abonnieren“ zum Artikel gehört.

Schritt für Schritt migrieren

Arbeite mit einer Kopie und vergleiche den neuen Inhalt mit der sichtbaren Originalseite.

  1. HTML-Ausschnitt wählenKopiere den Hauptinhalt oder öffne eine passende .html-Datei.
  2. Markdown erzeugenPrüfe Überschriften, Links, Listen, Tabellen, Bilder, Zitate und Code.
  3. Seitengerüst entfernenLösche Navigation, Werbeaufrufe, Trackinglinks und wiederholte Fußzeilentexte.
  4. Im Zielsystem testenSpeichere die .md-Datei und rendere sie dort, wo sie später veröffentlicht wird.

Überschriftenhierarchie reparieren

Webvorlagen wählen Überschriftenebenen manchmal wegen ihrer Optik. Ein Modul kann h4 verwenden, obwohl kein h3 vorausgeht, und der Website-Name kann auf jeder Seite als h1 auftauchen.

Lasse im migrierten Dokument ein H1 für den eigentlichen Titel und ordne Hauptabschnitte als H2 sowie echte Unterabschnitte als H3 ein.

Unruhige Hierarchie
# Website
#### Installation
## Erster Schritt
#### Optionen
Bereinigte Hierarchie
# Installation
## Erster Schritt
### Optionen

Links und Bilder an den neuen Ort anpassen

Ein relativer Link wie `/hilfe` funktioniert nur im passenden Domainkontext. Überführe wichtige Ziele in absolute URLs oder passe sie an die neue Struktur an. Entferne unnötige Trackingparameter.

Bildpfade wie `../uploads/bild.jpg` hängen ebenfalls vom alten Speicherort ab. Lege fest, ob du Dateien herunterlädst, neu hochlädst oder kontrollierte absolute URLs verwendest. Überarbeite den Alternativtext im jeweiligen Kontext.

Komplexe Tabellen und interaktive Komponenten

Markdown-Pipe-Tabellen besitzen keine verbundenen Zellen oder mehrstufigen Kopfbereiche. Vereinfache die Tabelle, teile sie auf oder behalte bereinigtes HTML, wenn der Zielrenderer es zulässt.

Formulare, Karussells, Tabs, Akkordeons, eingebettete Videos und interaktive Grafiken besitzen keine universelle Markdown-Zeile. Ersetze sie durch einen Link, eine statische Abbildung, eine Erklärung oder eine Komponente des neuen Systems.

WebelementMögliche Entscheidung
Einfache TabelleIn Pipe-Tabelle umwandeln und prüfen
Tabelle mit verbundenen ZellenVereinfachen, teilen oder erlaubtes HTML behalten
FormularIm Zielsystem neu bauen und verlinken
VideoLink, Vorschaubild oder Zielkomponente nutzen
AkkordeonIn Abschnitte mit Überschriften aufteilen

Qualitätskontrolle vor der Veröffentlichung

Rendere die Datei mit einem ähnlichen Dialekt wie das Ziel und prüfe Quelle und Ansicht.

  • Genau ein H1 und logische Abschnittsebenen.
  • Verschachtelte Listen behalten ihre Tiefe.
  • Tabellen haben konsistente Spalten und bleiben auf Mobilgeräten lesbar.
  • Relative Links und alte Domains sind korrigiert.
  • Bilder laden und besitzen sinnvollen Alternativtext.
  • Code behält Leerzeichen, Zeichen und Sprachangabe.
  • Navigation, Banner, Freigabeschaltflächen und alte Fußzeile sind entfernt.
  • Keine Information hängt nur von einer verschwundenen Interaktion ab.

Passende Werkzeuge

Markdown in HTMLBereinigte Quelle wieder im Web veröffentlichenMarkdown formatierenQuelle nach der Migration normalisierenMarkdown-VorschauErgebnis gerendert kontrollieren
FAQ

Häufige Fragen

Kann ich eine URL direkt in Markdown umwandeln?

Das Werkzeug verarbeitet eingefügtes oder geöffnetes HTML. Ein sicherer Abruf beliebiger Webseiten mit dynamischem Inhalt und Zugriffsschutz ist nicht Teil der Funktion.

Wird CSS übernommen?

Nein. Markdown beschreibt leichte Struktur. Das Design muss im neuen Zielsystem erstellt werden.

Was geschieht mit komplexen HTML-Tabellen?

Zusammengeführte Zellen lassen sich nicht portabel als Pipe-Tabelle darstellen. Vereinfache die Tabelle oder behalte erlaubtes, bereinigtes HTML.

Wie verhindere ich defekte Links?

Prüfe relative Pfade, alte Domains und Trackingparameter und teste alle wichtigen Ziele nach der Veröffentlichung.