Mit Markdown schreibst du formatierten Text mit einfachen Zeichen — # für eine Überschrift, - für einen Aufzählungspunkt, **fett** für Betonung. HTML ist die getaggte Auszeichnung, die Browser tatsächlich rendern. Markdown in HTML umzuwandeln macht aus deiner Kurzschrift <h1>, <ul> und <strong>; der umgekehrte Weg macht aus unübersichtlichem HTML wieder sauberes Markdown.
Genau das, was unser Konverter ausgibt. Die Eingabe
## Notes/See the [docs](/tools/) for **details**.plus eine zweiteilige Liste ergibt in unserem Markdown-zu-HTML-Konverter:<h2>Notes</h2> <p>See the <a href="/tools/">docs</a> for <strong>details</strong>.</p> <ul> <li>one</li> <li>two</li> </ul>Beachte, was nicht dazukommt: kein umschließendes
<div>, keine Klassen, kein<html>-Skelett — nur die Blockelemente. Genau das willst du, wenn du in ein CMS einfügst, das sein eigenes Layout mitbringt. Die Listenpunkte stecken auch nicht in<p>, weil die Quellliste tight und nicht loose ist.
Was aus Markdown wird
| Markdown | HTML |
|---|---|
# Titel | <h1>Titel</h1> |
- Punkt | <ul><li>Punkt</li></ul> |
**fett** | <strong>fett</strong> |
[Text](url) | <a href="url">Text</a> |
```Code``` | <pre><code>Code</code></pre> |
Ein Konverter durchläuft dein Markdown und gibt die passenden Tags aus. Die meisten Tools folgen GitHub-Flavored Markdown, das zusätzlich zur ursprünglichen Spezifikation Tabellen, Aufgabenlisten und umzäunte Codeblöcke unterstützt.
Zwei Konstrukte, direkt aus unserem Markdown-↔-HTML-Konverter. Eine Überschrift liefert
<h1>Title</h1>
eine Zeile mit Hervorhebung liefert
<p><strong>bold</strong> and <em>italic</em></p>
Die Überschrift kam nackt zurück, die Hervorhebungszeile in <p> gewickelt. Das ist die Regel hinter den meisten Markdown-Überraschungen: Blockkonstrukte ersetzen den Absatz, Inline-Konstrukte leben darin. Links sind ebenfalls inline, [link](https://yunknow.cc/) erzeugt also
<p><a href="https://yunknow.cc/">link</a></p>
mit dem Anker im Absatz verschachtelt statt allein stehend.
Markdown zu HTML
Das ist die übliche Richtung: Du hast ein README oder einen Blogbeitrag in Markdown geschrieben und brauchst HTML für eine Seite, eine E-Mail oder ein CMS. Markdown einfügen, umwandeln, HTML kopieren. Eine Vorschau hilft dir zu prüfen, ob die Formatierung stimmt, bevor du es verwendest.
HTML zu Markdown
Die Umkehrung ist praktisch zum Aufräumen. Kopiere einen Abschnitt einer Webseite, und er kommt als Gewirr aus <div>s und Inline-Styles an; die Umwandlung in Markdown reduziert ihn auf die Wörter und die Struktur, die du für Notizen oder Dokumentation wirklich willst. HTML-eigene Details — Inline-CSS, komplexe verschachtelte Tabellen — lassen sich nicht immer in Markdown ausdrücken und werden vereinfacht.
Häufige Markdown-Fallstricke
Die meisten „Warum wird das nicht gerendert?”-Momente kommen von wenigen Gewohnheiten:
- Vor Listen gehört eine Leerzeile. Klebt eine Liste direkt unter einem Absatz, behandeln viele Parser alles als einen Absatz. Erst eine Zeile frei lassen.
- Ein einzelner Zeilenumbruch wird meist ignoriert. Markdown faltet einen Umbruch zu einem Leerzeichen. Für einen harten Umbruch die Zeile mit zwei Leerzeichen beenden oder eine Leerzeile für einen neuen Absatz setzen.
- Unterstriche in Wörtern können kursiv machen. In manchen Dialekten wird bei
snake_case_nameder mittlere Teil kursiv. In Backticks setzen oder die Unterstriche escapen:snake\_case\_name. - Vier Leerzeichen Einrückung ergeben einen Codeblock. Versehentliche Einrückung verwandelt Text still in
<pre>-Ausgabe.
Und hier der Stolperstein, der die meisten überraschten Fehlermeldungen erzeugt. Diese Eingabe hat zwischen zwei Textzeilen nur einen Zeilenumbruch, und der Konverter liefert
<p>line one
line two</p>
Der Umbruch überlebt im Quelltext, erzeugt aber kein <br> — beide Zeilen landen in einem <p>, und der Browser rendert sie als eine fortlaufende Zeile. Ein einzelner Zeilenumbruch ist in Markdown kein Zeilenumbruch; nötig sind zwei Leerzeichen am Zeilenende, ein Backslash oder eine Leerzeile für einen neuen Absatz. Listen dagegen bekommen echte Struktur:
<ul>
<li>one</li>
<li>two</li>
</ul>
Deshalb sind „meine Zeilenumbrüche sind verschwunden” und „meine Liste ging problemlos” dieselbe Tatsache von zwei Seiten.
Häufige Fragen
Ist Markdown standardisiert? Am nächsten kommt CommonMark, ergänzt durch GitHub-Flavored Markdown mit Tabellen, Aufgabenlisten und Durchstreichung. Die Dialekte unterscheiden sich — eine Fußnote, die auf einer Seite funktioniert, tut es auf einer anderen vielleicht nicht.
Darf HTML in Markdown stehen? Ja — die meisten Renderer reichen rohes HTML einfach durch, praktisch für ein <sub> oder <details>, das Markdown nicht ausdrücken kann. Sanitizing-Renderer entfernen es unter Umständen.
Enthält die Ausgabe <html> und <body>? Nein. Konverter geben ein HTML-Fragment aus — nur die <h1>, <p> und so weiter. Für eine eigenständige Seite selbst in ein vollständiges Dokument einbetten. Eine andere, weit strengere Auszeichnungssprache stellt unser Leitfaden zu XML vor.
Übersteht Text den Hin- und Rückweg? Grundstrukturen — Überschriften, Listen, Links und Betonung — ja. HTML-eigene Feinheiten wie Inline-CSS oder tief verschachtelte Tabellen gehen bei der Rückumwandlung nach Markdown verloren, weil Markdown sie schlicht nicht ausdrücken kann.
Privat, direkt im Browser
Der Markdown-⇄-HTML-Konverter läuft komplett auf deinem Gerät — nichts wird hochgeladen — und zeigt eine Sandbox-Live-Vorschau, die das Layout rendert, ohne Skripte auszuführen. Wandle in beide Richtungen um, sieh dir die Vorschau an und kopiere oder lade herunter.
Verwandte Tools
- Behältst du beim Schreiben die Länge im Blick? Nutze den Wortzähler.
- Eingefügter Text voller Zeilenumbrüche? Räume ihn mit dem Text-Reiniger auf.