markitdown.ai
Loslegen

Konverter

Markdown zu HTML umwandeln

Markdown zu HTML ist ein Browser-Konverter, der CommonMark und GitHub Flavored Markdown in bereinigtes HTML verwandelt – inklusive Überschriften, Tabellen, Aufgabenlisten und eingezäuntem Code. Nichts wird hochgeladen; derselbe Renderer läuft hinter POST /v1/convert/markdown/html.

# markitdown-ai

Convert documents to clean Markdown.

## Features

- PDF, Word, and slides
- [x] Tables stay tables
- [ ] Mermaid coming later

## Install

```bash
pnpm add @markitdown-ai/sdk
```

## API

| Method | Path |
| --- | --- |
| POST | /v1/convert/{name} |
| GET | /v1/conversions/{id} |

So geht's

So wandelst du Markdown in HTML um

Was du einfügen kannst

  • Beliebiges Markdown: CommonMark plus GitHub-Flavored-Markdown-Tabellen, Aufgabenlisten und Durchstreichungen
  • Das Rendering läuft in deinem Browser – während du tippst, wird nichts hochgeladen
  • Kein Konto nötig, um anzusehen, zu kopieren oder herunterzuladen
  • Kein festes Größenlimit; ein sehr großes Dokument ist durch den Arbeitsspeicher deines Browsers begrenzt
Markdown zu HTML: Markdown-Editor wird links zu einer gerenderten HTML-Seite

Warum nutzen

Warum du diesen Markdown-zu-HTML-Konverter nutzen solltest

Ein CMS-Feld, eine statische Website und ein E-Mail-Editor wollen Markup, nicht Markdown-Quelltext. Dieser Konverter bewahrt die Teile, die Bedeutung tragen, und entfernt, was rohes HTML unsicher machen würde.

Läuft in deinem Browser

Füge Markdown ein und die HTML-Vorschau aktualisiert sich lokal. Nichts wird hochgeladen, und für Vorschau, Kopieren oder Herunterladen ist kein Konto nötig.

CommonMark plus GFM

Überschriften, Listen, Links, Blockzitate und eingezäunter Code folgen CommonMark; Tabellen, Aufgabenlisten und Durchstreichungen folgen GitHub Flavored Markdown.

Standardmäßig bereinigt

Script-Tags, Inline-Event-Handler und unsichere href- oder src-Schemata werden entfernt, sodass das HTML sicher in eine Seite eingefügt werden kann, die du nicht vollständig kontrollierst.

Fragment oder vollständiges Dokument

Kopiere nur das gerenderte Markup für eine Seite, die ihr Layout selbst besitzt, oder lade ein vollständiges HTML-Dokument mit dem Stil der Vorschau herunter.

Überschriften-Anker

Jede Überschrift erhält eine stabile, URL-sichere id, die genauso erzeugt wird wie in der API, damit ein Inhaltsverzeichnis oder ein Deep-Link nach der Veröffentlichung weiter funktioniert.

Dieselbe Engine wie die API

Diese Vorschau und POST /v1/convert/markdown/html nutzen denselben Renderer, sodass das hier kopierte HTML bytegenau mit einem automatisierten Aufruf übereinstimmt.

Das Problem

Warum rohes Markdown nicht direkt auf eine Webseite kann

Markdown-Syntax ist kein HTML

Ein CMS-Feld, eine E-Mail-Vorlage oder ein Static-Site-Theme will Markup, nicht Markdown-Quelltext, also muss der Rohtext erst konvertiert werden, bevor er gestylt oder eingebettet werden kann.

Ein einfacher Parser verpasst GFM

Tabellen, Aufgabenlisten und Durchstreichungen sind Erweiterungen von GitHub Flavored Markdown; ein reiner CommonMark-Parser rendert sie als wörtliche Pipe-Zeichen und Tilden statt als Struktur.

Nicht vertrauenswürdiges Markdown kann Skripte tragen

Markdown kann rohes HTML einbetten, einschließlich <script>-Tags und Inline-Event-Handlern, die entfernt werden müssen, bevor die Ausgabe sicher in eine Seite eingefügt werden kann, die du nicht vollständig kontrollierst.

Markdown in HTML umwandeln: fehlerhaft eingefügter Text neben einer sauberen Markdown-Struktur

Was erhalten bleibt

Was dieser Markdown-zu-HTML-Konverter bewahrt

Überschriften und Inline-Text
ATX- und Setext-Überschriften, Hervorhebungen, Links und Blockzitate folgen CommonMark; jede Überschrift erhält zusätzlich eine URL-sichere id, die aus ihrem Text erzeugt wird.Source: CommonMark Spec
Tabellen, Aufgabenlisten und Durchstreichungen
Tabellen aus GitHub Flavored Markdown werden zu <table>-Elementen, [ ]- und [x]-Einträge zu Kontrollkästchen und ~~Text~~ zu <del>.Source: GitHub Flavored Markdown Spec
Bereinigtes Markup
Rohe <script>-Tags, Inline-Event-Handler und href- oder src-Werte außerhalb von http, https und mailto werden entfernt, bevor das HTML zurückgegeben wird.Source: HTML Living Standard
Eingezäunter Code
Eingezäunte Codeblöcke behalten ihren Inhalt und ihr Sprachlabel; die Browser-Vorschau selbst wendet kein Syntax-Highlighting-Theme an.Source: CommonMark Spec
Rohes HTML in der Quelle
Markdown, das andere rohe HTML-Tags einbettet, läuft durch denselben Sanitizer, sodass ein eingebettetes Tag nie als vertrauenswürdiges Markup behandelt wird.Source: HTML Living Standard

Verifizierter Markdown-zu-HTML-Auszug· https://markitdown.ai/blog/why-pdfs-break-llms

<h2 id="what-actually-goes-wrong">What actually goes wrong</h2><p>When teams pipe documents straight into an LLM or a retrieval index, a few failure modes show up again and again:</p><ul><li><strong>Reading order breaks.</strong> Multi-column layouts interleave. A two-column page becomes "line 1 left, line 1 right, line 2 left, line 2 right…", so a sentence a human reads top-to-bottom arrives at the model scrambled.</li><li><strong>Tables collapse.</strong> Copy-paste turns a table into a loose run of numbers. The relationship between a header and its cell — the entire point of a table — is gone.</li><li><strong>Headings disappear.</strong> The visual hierarchy (this is a section, this is a subsection) is encoded as font size and weight, not structure. Strip the styling and you get one undifferentiated wall of text.</li><li><strong>Noise creeps in.</strong> Page numbers, running headers, hyphenated line breaks, and stray ligatures end up inline, polluting prompts and embeddings alike.</li></ul><p>Read more in the <a href="https://markitdown.ai/blog/why-pdfs-break-llms">full article</a>.</p>

Anwendungsfälle

Anwendungsfälle für die Markdown-zu-HTML-Konvertierung

Überall dort, wo ein Ziel Markup will, während die Quelle Markdown bleibt, ist dieser Konverter der Zwischenschritt.

Dokumentation und statische Websites

Verwandle ein README oder einen Markdown-Artikel aus einer Wissensdatenbank in das HTML, das ein Static-Site-Generator oder ein CMS-Feld erwartet.

E-Mail- und Newsletter-Entwürfe

Verfasse eine Nachricht in Markdown, wandle sie in HTML um und füge das Fragment in den E-Mail-Editor ein, aus dem du tatsächlich versendest.

Eine LLM-Antwort aufräumen

ChatGPT, Claude und Gemini geben Markdown zurück; wandle es in HTML um, wenn das Ziel – ein Ticket, eine Wiki-Seite – Markup statt roher Sternchen rendert.

Entwickler, die das Rendering automatisieren

Rufe den Render-Endpunkt aus einer Pipeline auf, die Markdown speichert, aber HTML ausliefert, ohne in jeden Dienst eine Markdown-Bibliothek einzubauen.

Markdown zu HTML online: die gerenderte Seite wird für Websites, E-Mail und Dokumente genutzt

API

Markdown-zu-HTML-API für Entwickler

Das Rendering läuft synchron und kostet 0 Credits – es zählt dennoch gegen das Rate-Limit pro Minute deines Plans. Sende Markdown als Text oder verweise auf eine gespeicherte .md-Datei an POST /v1/convert/markdown/html mit deinem API-Schlüssel; bereinigtes HTML kommt direkt in der Antwort zurück.

API-Leitfaden lesen
curl -X POST https://api.markitdown.ai/v1/convert/markdown/html \  -H "x-api-key: mdai_…" \  -H "Content-Type: application/json" \  -d '{ "text": "# Notes\n\nHello **world**." }'

Leitfaden

Dokumentation und statische Websites

Die meisten Dokumentations-Tools halten Markdown als bearbeitbare Quelle und erzeugen HTML erst beim Build oder in der Vorschau. Dieser Konverter lässt dich genau diesen Erzeugungsschritt isoliert prüfen: Füge dasselbe Markdown ein, das dein Site-Generator liest, und bestätige, dass Überschriften, Tabellen und Codeblöcke so herauskommen, wie dein Theme es erwartet, bevor du eine Änderung festschreibst. Er ist auch nützlich, wenn ein CMS-Feld HTML akzeptiert, deine Autoren aber in Markdown arbeiten – einmal konvertieren, das Fragment einfügen und die Markdown-Quelle für die nächste Revision weiterbearbeiten, statt das erzeugte Markup von Hand zu ändern.

  • Behalte die Markdown-Datei als deine Quelle der Wahrheit; behandle das HTML als Build-Artefakt.
  • Vergleiche die gerenderte Ausgabe mit dem tatsächlichen Theme deiner Website, nicht nur mit dem Vorschau-Stil dieser Seite.
  • Führe die Konvertierung nach jeder Quelländerung erneut aus, statt das erzeugte HTML von Hand zu flicken.

Bereinigung

Markdown kann rohes HTML einbetten, und dieses rohe HTML kann ein <script>-Tag oder einen Inline-Event-Handler wie onclick enthalten. Bevor dieser Konverter ein Ergebnis zurückgibt, läuft das Markup durch einen Sanitizer, der Script-Elemente entfernt, jedes Attribut streicht, das mit "on" beginnt, und nur http-, https- und mailto-Links sowie Bildquellen zulässt. Was übrig bleibt, ist die semantische Struktur – Überschriften, Absätze, Listen, Tabellen, Links, Bilder und Code –, nicht dekoratives Styling. Der Konverter fügt weder eine Klasse noch eine CSS-Datei in die Fragment-Ausgabe ein; der Download eines vollständigen Dokuments ergänzt das Theme, das du in der Vorschau siehst, damit die Datei für sich allein korrekt geöffnet wird.

Fragment oder vollständige Seite

Ein Fragment ist das innere Markup – die Überschriften, Absätze und Tabellen – ohne umgebendes <html> oder <head>. Es gehört in eine Seite, die ihre eigene Dokumentstruktur und ihr Styling bereits definiert, etwa ein CMS-Inhaltsfeld oder eine Komponente, die Kinder rendert. Ein vollständiges Dokument ergänzt eine Doctype, einen Titel und ein kleines Stylesheet, damit die Datei direkt im Browser geöffnet oder eigenständig gespeichert werden kann. Ein vollständiges Dokument in ein Inhaltsfeld einzufügen, das ein Fragment erwartet, ist ein häufiger Fehler: Der Browser rendert es vielleicht trotzdem, aber die verschachtelten <html>- und <head>-Tags sind dort ungültig und können nachgelagerte Tools verwirren, die ein Fragment erwarten.

Weitere Markdown-Konverter

Need it in your code? Use the developer API. Converting at scale? See plans and pricing.

FAQ

Fragen zu Markdown zu HTML

Wie funktioniert Markdown zu HTML?

Füge Markdown ein oder tippe es, und der Konverter rendert bereinigtes HTML lokal in deinem Browser, mit demselben Renderer wie POST /v1/convert/markdown/html. Während du tippst, wird nichts hochgeladen.

Unterstützt Markdown zu HTML GitHub Flavored Markdown?

Ja. Tabellen, Aufgabenlisten und Durchstreichungen folgen der Spezifikation von GitHub Flavored Markdown, zusammen mit CommonMark-Überschriften, -Listen, -Links und -Code.

Ist die HTML-Ausgabe bereinigt?

Ja. Script-Tags, Inline-Event-Handler und unsichere href- oder src-Schemata werden entfernt, sodass das HTML sicher in eine Seite eingefügt werden kann, die du nicht vollständig kontrollierst.

Kann ich ein vollständiges HTML-Dokument statt eines Fragments bekommen?

Ja. Wähle ein vollständiges Dokument mit dem Stil der Vorschau oder kopiere nur das Fragment für eine Seite, die ihr Layout selbst besitzt.

Brauche ich ein Konto, um Markdown in HTML umzuwandeln?

Nein. Vorschau, Kopieren und Herunterladen funktionieren ohne Anmeldung, weil das Rendering lokal in deinem Browser läuft.

Ruft das während des Tippens die API auf?

Nein. Das Tippen bleibt lokal. Die API läuft nur, wenn du POST /v1/convert/markdown/html direkt aufrufst, etwa aus einem Skript.

Gibt es ein Größenlimit für das Markdown, das ich konvertiere?

Es gibt kein festes Upload-Limit, weil nichts hochgeladen wird; die praktischen Grenzen hängen vom Arbeitsspeicher deines Browsers bei sehr großen Dokumenten ab.

Kann ich Markdown aus Code in HTML umwandeln?

Ja. Sende dein Markdown als Text oder eine gespeicherte .md-Datei an /v1/convert/markdown/html mit einem API-Schlüssel. Es kostet 0 Credits. Siehe /developers.

Markdown überall in HTML umwandeln.

Kostenlos testen – keine Anmeldung nötig.

LoslegenKonverter öffnen