Claude-Team bei Anthropic bevorzugt HTML gegenüber Markdown als Ausgabeformat

Markdown als Ausgabeformat hat gegenüber HTML wichtige Nachteile. Deshalb bevorzugt das Claude-Team von Anthropic inzwischen HTML bei der Ausgabe von Ergebnissen. Aber gilt das auch für HTML als Input-Format?

 

 Anzeige

Markdown hat sich als ein wichtiges Dateiformat für die Kommunikation mit KI-Agenten etabliert, weil es einfach, portabel und leicht zu bearbeiten ist. Doch mit der zunehmenden Leistungsfähigkeit von KI-Agenten wie Claude zeigt das Format zunehmend seine Grenzen auf. Das Claude Code-Team bei Anthropic setzt daher immer häufiger auf HTML als primäres Ausgabeformat. Die Vorteile von HTML gegenüber Markdown beschreibt ein Mitglied des Teams auf X.

Überlegene Informationsdichte

Markdown ist für einfache Dokumentenstrukturen geeignet, stößt aber bei komplexeren Daten an seine Grenzen. Beispiele sind ineffiziente ASCII-Diagramme oder Versuche, Farben durch Unicode-Zeichen darzustellen. HTML dagegen bietet eine höhere Informationsdichte: Es unterstützt zum Beispiel Tabellen, CSS-Design, SVG-Illustrationen, Skripte für Code-Snippets sowie räumliche Daten. Es gibt fast nichts, was Claude lesen kann, das nicht effizienter in HTML dargestellt werden könnte.

Abbildung 1: Markdown vs. HTML

Visuelle Klarheit und Lesbarkeit

Weil Agenten immer längere Spezifikationen und Pläne schreiben, wird Markdown unübersichtlich. In der Praxis liest kaum jemand Markdown-Dateien, die länger als 100 Zeilen sind. HTML-Dokumente lassen sich dagegen durch Tabs, Illustrationen und Links visuell optimal strukturieren und sogar für Mobilgeräte responsiv gestalten.

Leichteres Teilen

Markdown-Dateien werden von Browsern nativ oft nicht gut gerendert. Deshalb müssen sie als Anhänge verschickt werden. HTML-Dateien können dagegen einfach hochgeladen und per Link geteilt werden.

SEO-Beratung: Wir sind Ihre Experten

Wir bringen gemeinsam Ihre Website nach vorne. Profitieren Sie von jahrelanger SEO-Erfahrung.

Unsere Beratungsleistungen

Christian Kunz

SEO Experte

David Wulf

SEO Experte

Sven Häwel

Offpage-Experte

Zwei-Wege-Interaktion

Im Gegensatz zu statischem Markdown ermöglicht HTML interaktive Dokumente. Möglich sind zum Beispiel, Schieberegler oder Buttons, um Designs anzupassen oder Algorithmen zu testen. Die vorgenommenen Änderungen lassen sich dann über einen Export-Button direkt wieder als Prompt kopieren und in Claude Code einfügen.

Datenaufnahme (Data Ingestion)

Claude Code kann Kontext aus dem Dateisystem, Tools wie Slack, dem Webbrowser oder der Git-Historie aufnehmen. Diese großen Datenmengen lassen sich in HTML ideal gruppieren und durch Diagramme visualisieren.

Use Cases

 HTML dient als eine Art interaktive Leinwand für Problemlösungen. Zu den konkreten Anwendungsfällen zählen:

• Spezifikationen & Planung: Die Erstellung mehrerer Design-Konzepte in einem Grid zum direkten Vergleich oder interaktive Implementierungspläne mit Mockups.
• Code Review: Bessere Visualisierung durch Diffs mit Inline-Annotationen, farbkodierten Warnungen und Flowcharts, was oft hilfreicher ist als die Standard-Ansicht bei GitHub.
• Design & Prototyping: Schnelles Testen von Animationen und Komponenten mit interaktiven Elementen.
• Berichte & Research: Erstellung von tiefgreifenden Erklärseiten, etwa für komplexe Rate-Limiter, Status-Updates oder Slideshows mit SVG-Diagrammen.
• Benutzerdefinierte Wegwerf-Editoren: Die Erstellung maßgeschneiderter Schnittstellen für einmalige Aufgaben wie ein Kanban-Board für Jira/Linear-Tickets zum Drag-and-Drop oder Side-by-Side-Editoren für das Tuning von Prompts.

Nachteile

Genannt werden auch einige Nachteile von HTML gegenüber Markdown.

HTML nutzt zum Beispiel mehr Tokens, und die Generierung dauert zwei- bis viermal länger als bei Markdown. Durch große Kontextfenster fällt der höhere Verbrauch allerdings kaum auf, und die besseren Ergebnisse rechtfertigen die Wartezeit.

Ein weiterer Nachteil ist, dass HTML-Diffs im Gegensatz zu Markdown sehr unübersichtlich und schwer in Git zu reviewen sind.

Ist HTML auch als Input-Format besser als Markdown?

Wenn HTML das bessere Ausgabeformat für KI-Agenten ist, dann stellt sich natürlich die Frage, ob das auch für die umgekehrte Richtung gilt: Ist also HTML das bessere Format für die Verarbeitung von Informationen durch LLMs? 

Zumindest bisher galt: Für die überwiegende Mehrheit der Anwendungsfälle dürfte Markdown weiter das bessere Inputformat sein. Das hat vor allem die folgenden Gründe:

LLMs verarbeiten Text in sogenannten Tokens. HTML enthält viel Rauschen in Form von Tags (<div>, <span>, <p>), Attributen (class, style) und Verschachtelungen. Ein Text in Markdown verbraucht deshalb weniger Tokens als derselbe Text in HTML.

Weil Markdown kompakter ist, kann man dem Modell viel mehr eigentlichen Inhalt und Kontext übergeben, bevor das Limit des Kontextfensters erreicht ist.

Markdown trennt den Inhalt außerdem strikt vom Design. Es konzentriert sich rein auf die Informationsstruktur wie Überschriften, Listen, Code-Blöcke. Das Modell wird nicht durch irrelevante Layout- oder CSS-Informationen abgelenkt und kann die Logik des Textes besser erfassen.

LLMs wurden mit großen Mengen von Markdown-Texten trainiert (z. B. GitHub, Reddit, Stack Overflow, konvertierte Wikipedia-Artikel). Sie bearbeiten und strukturieren ihre eigenen Antworten standardmäßig in Markdown.

Mit der zunehmenden Leistungsfähigkeit der Modelle könnte sich allerdings auch hier ein Wandel ergeben, der dazu führt, dass die Vorteile von HTML gegenüber Markdown die Nachteile auch als Input-Format überwiegen.