Übersetzung
"Die KI schreibt so lang, dass ich es gar nicht richtig lese 😅"
"Ich zahle über 15.000 Yen im Monat für Claude Code, aber ich habe nicht das Gefühl, dass es sich lohnt."
Viele Menschen sind bereits zufrieden damit, dass sie KI nutzen, aber nur wenige setzen es tatsächlich in Ergebnisse um. Es ist ein Zustand des "Gefühls, es genutzt zu haben."
Hattest du diese Erfahrungen mit Claude Code?
- Du bittest es am Montagmorgen, "die Wettbewerbertrends der letzten Woche zusammenzufassen", und es liefert einen langen Bericht. Du wirfst einen Blick darauf und lässt ihn ungelesen liegen.
- Du vermutest, dass wenn du die KI-generierten Materialien nicht richtig liest, deine Teammitglieder sie erst recht nicht lesen.
- Du zahlst über 3.000 Yen monatlich für Claude Code, aber die Ergebnisse wurden noch nie in einem Meeting oder Vorschlag verwendet.
- ChatGPT und Claude.ai liefern schöne Ausgaben, aber warum gibt Claude Code nur Markdown aus, was so anstrengend zu lesen ist?
Dieser Artikel ist für diese Menschen.
Wenn du ihn zu Ende gelesen hast, wirst du in der Lage sein, auf natürliche Weise Materialien aus Claude Code zu erstellen, die sowohl du als auch andere tatsächlich lesen.
Du wirst auch die Erkenntnis mitnehmen, dass "in welchem Format du ausgibst" ein viel größerer Faktor für die Benutzerbewertung ist als "was du Claude Code fragst."
Thariq Shihipar (@trq212), ein Entwickler bei Anthropic, der Claude Code tatsächlich baut, schrieb auf X über eine Denkweise, die sich im Unternehmen verbreitet, und es wurde einer der am meisten gespeicherten und geteilten Beiträge in der Claude Code-Community.
Es erhielt sofort nach der Veröffentlichung eine enorme Resonanz.
Dies ist nicht nur ein kleiner Tipp für KI-Enthusiasten; es ist eine Geschichte über den Menschen, der das Tool gebaut hat, der Markdown, den impliziten Standard der KI-Branche, in Frage stellt und sagt: "Es ist nicht mehr der Weg."
Ich fand das wichtig und habe mich entschieden, es sofort auf Japanisch zu erklären.
Zwei Dinge, bevor du mit dem Lesen beginnst:
- Lesezeichen setzen. Nimm dir diese Woche etwas Zeit, um die Ausgabe in HTML auszuprobieren.
- Wenn du Teammitglieder hast, die Claude Code nutzen, teile dies mit ihnen. Die Art und Weise, wie deine Wochenberichte und PR-Reviews "gelesen" werden, wird sich ab nächster Woche sichtbar verändern.
Ich werde den Inhalt aufschlüsseln und erklären, während ich ihn in die japanische Geschäftswelt übersetze 👇
Originalbeitrag hier:
https://x.com/trq212/status/2052809885763747935
Der Anthropic-Entwickler selbst verwendet kein Markdown mehr
Dies ist der Ausgangspunkt. Thariq Shihipar (@trq212), der den Originalbeitrag geschrieben hat, ist der Entwickler, der Claude Code bei Anthropic baut. Das Verhalten, bei dem Claude im "Plan-Modus" Rückfragen an den Benutzer stellt, um Anforderungen zu verfeinern, war eine Funktion, die er persönlich implementiert hat.
Er sagt, dass er Markdown von dem Tool, das er baut, nicht mehr akzeptiert. In seinen eigenen Worten ist Markdown für ihn zu einem einschränkenden Format geworden.
Dies ist nicht nur eine persönliche Vorliebe. Thariq erwähnt, dass sich die HTML-Nutzung innerhalb des Claude Code-Teams selbst verbreitet. Die Menschen, die das Tool bauen, geben das Markdown, das es produziert, auf und wechseln zu HTML.
Und die Beweise sind greifbar. Auf der Demo-Seite https://thariqs.github.io/html-effectiveness/ gibt es 20 eigenständige HTML-Beispiele. Ein Vergleich von drei Ansätzen für debounced Search, Mikrointeraktionen, die ein Erfolgserlebnis bei der Aufgabenerfüllung schaffen, Designsystem-Token-Listen, tabbasierte Erklärungen für Codebeispiele und Lesematerial mit Glossar am Rand. All dies sind reale Beispiele für die Umwandlung von "Dokumenten, die man nur überfliegt" in "Dokumente, die bis zum Ende gelesen werden." Du kannst sie jetzt in deinem Browser öffnen.
Beim Lesen solltest du etwas erkennen. Die Artifacts, die du normalerweise in ChatGPT oder Claude.ai erhältst – diese "UI mit Tabs", "farbigen Diagrammen" und "interaktiven Buttons" – werden tatsächlich als HTML ausgegeben. Die Erkenntnis hier ist: "Der Grund, warum sie so gut aussahen, war der Unterschied im Format selbst." Jetzt kann dieselbe Welt mit Claude Code zu dir nach Hause kommen.
Bisher war KI-generierter Text fast ausschließlich Markdown. Derjenige, der es baut, beginnt leise Einspruch zu erheben und sagt "nicht mehr." Das ist der Kern der Neuigkeit. Aber für dich, der täglich mit KI arbeitet, ist dies eine Geschichte, die ab Montagmorgen wirksam sein wird.
Markdown war der implizite Standard der KI-Branche
Lass uns die Annahmen bestätigen, die wir für selbstverständlich gehalten haben. Ohne dies könnte der Wechsel zu HTML wie eine Geschmacksfrage aussehen.
Bisher war Markdown der De-facto-Standard für KI-Ausgaben. Denk an den Text zurück, den du täglich siehst:
- CLAUDE.md im Projektstammverzeichnis, *.md für Agent-Definitionen, SKILL.md für Skills.
- Anthropics offizielle Dokumentation, Claude.ai-Hilfe und verschiedene Claude Code-Anleitungen.
- Konkurrierende KI-Entwicklungstools, Cursor-Regeln, GitHub Copilot-Anweisungen und Cline-Anweisungen basieren alle auf .md.
- Interne Wikis, GitHub-READMEs, aus Notion exportierter Text und in Slack eingefügte Meeting-Protokolle.
- Zusammenfassungstexte aus ChatGPT-Chats.
Alles wurde unter der Annahme von Markdown aufgebaut. Es ist schwieriger, ein anderes Format als Markdown in den Textinformationen zu finden, denen du im Umgang mit KI begegnest.
Das Phänomen, dass Karpathys CLAUDE.md-Muster über 80.000 Sterne auf GitHub gesammelt hat, geschah genau, weil Markdown die gemeinsame Sprache der Branche war.
In Thariqs Worten ist Markdown zum Mainstream-Format für Agenten geworden. Er ist jemand, der lange Zeit Tools auf der Markdown-Prämisse gebaut hat.
Diese Person hat nun klar gesagt: Markdown ist für mich zu einem einschränkenden Format geworden. Dies ist der Moment, in dem ein Anthropic-Insider einen Stein auf die Prämisse geworfen hat, auf der die gesamte Branche reitet.
Einfach ausgedrückt: Das Markdown, das du von Claude Code erhältst, die Regeln, die Cursor liest, und die KI-Ausgaben in deinem internen Wiki waren alle Teil desselben "Markdown ist in Ordnung"-Flusses. Derjenige, der es geschaffen hat, hat begonnen, einen anderen Kanal zu zeichnen.
Von hier aus gehen wir auf die Details ein, warum Markdown die Menschen nicht erreicht und womit man es ersetzen kann.
5 Gründe, warum Markdown nicht gelesen wird
Lass uns die Einschränkungen von Markdown organisieren. Dies geht nicht um technische Spezifikationen; es geht um deine tägliche Erfahrung von Montag bis Freitag. Ich habe die Vorteile von HTML aus dem Originalartikel aufgelistet, indem ich sie umgedreht habe, um die Schwächen von Markdown zu zeigen.
① Wenn es 100 Zeilen überschreitet, liest selbst du es nicht
Thariq selbst schreibt, dass er aufhört zu lesen, wenn eine Markdown-Datei 100 Zeilen überschreitet.
Wenn du Claude Code bittest, "die Wettbewerbertrends der letzten Woche zusammenzufassen", hast du wahrscheinlich die Erfahrung gemacht, die 120-zeilige Antwort zu schließen, ohne zu scrollen. Wenn derjenige, der es generiert hat, es nicht liest, wird es niemand im Team tun. Die Realität ist, dass nicht nur der Autor, sondern auch andere Mitglieder der Organisation nur überfliegen.
② Selbst wenn geteilt, öffnet es sich nicht schön im Browser, also berührt es niemand
Markdown wird nativ in Browsern nicht schön gerendert. Zeilenumbrüche brechen in Slack, die Formatierung wird in E-Mails zerstört, und es erfordert Aufwand, es für Vorschläge in PDF zu konvertieren oder Screenshots zu machen.
Jedes Mal, wenn du teilst, muss jemand die Arbeit erledigen, es in eine "lesbare Form" zu konvertieren. Markdown ist ein Format, das jedes Mal, wenn es geteilt wird, Reibung erzeugt, bis zu dem Punkt, dass Links oft nicht einmal angeklickt werden.
③ Keine Farben oder Diagramme, also wird nur der Umriss vermittelt
Du möchtest einen Unterschied in Zahlen hervorheben, eine Warnung in Rot zeigen oder einen Fluss mit Pfeilen darstellen. Um dies in Markdown zu tun, zeichnest du am Ende Diagramme mit ASCII-Zeichen oder drückst Farben mit Unicode-Rahmenzeichen aus.
Niemand möchte das entziffern, und der Schreiber wird müde. Selbst wenn Claude sich bemüht, ein Diagramm zu zeichnen, wird es am Ende überflogen.
④ Du kannst es nicht anfassen oder bewegen, also endet es mit dem Lesen
Du möchtest eine etwas ruhigere Farbe ausprobieren, die Geschwindigkeit einer Animation testen oder sehen, wie es aussieht, wenn du einen Wert um das 1,5-fache erhöhst.
Im Geschäftsleben gibt es häufige Situationen, in du es "ausprobieren" musst, um ein Urteil zu fällen. Das kannst du mit Markdown nicht. Du liest es, simulierst es im Kopf und sendest dann Anweisungen in Text zurück – eine ineffiziente Schleife.
⑤ Es bricht, wenn es auf dem Handy geöffnet wird
Slack, E-Mail oder Notion unterwegs. In der japanischen Geschäftswelt wird die Hälfte der geteilten Materialien zuerst auf dem Handy geöffnet.
Markdown-Layouts folgen nicht der Bildschirmbreite. Tabellen laufen horizontal über, Code-Blöcke werden umständlich umbrochen und die Überschriftenhierarchie wird unsichtbar. Der Wunsch zu lesen verschwindet in diesem Moment.
Lass uns dem einen Namen geben. Jedes Mal, wenn du ungelesenes Markdown produzierst, baut sich sowohl für den Sender als auch für den Empfänger bereits vor dem Öffnen Ermüdung auf. Die Kosten für das Scrollen von 100 Zeilen, das Beheben von Zeilenumbrüchen in Slack, das Scheitern der Kommunikation aufgrund fehlender Diagramme und Farben, die Verzögerung bei der Entscheidung, weil du nicht interagieren kannst, und das Brechen auf dem Handy.
All dies sind versteckte Gebühren, die täglich gezahlt werden. In diesem Artikel nennen wir dies die "Formatsteuer."
Dies ist keine kleine Steuer. Mehr als die Hälfte des Werts von Claude Code wird nicht durch den Inhalt der Ausgabe bestimmt, sondern durch "wen es erreicht und wie weit." Indem du in einem Format ausgibst, das die Menschen nicht erreicht, wirfst du im Wesentlichen die Hälfte deines Abonnements weg.
Wie man wechselt: Füge einfach "Als HTML-Datei ausgeben" hinzu
Du musst nicht zu viel nachdenken. Es gibt viel weniger zu tun, als du denkst.
Füge einfach eine Zeile am Ende deiner üblichen Claude Code-Anfrage hinzu. Die folgenden drei bedeuten dasselbe:
- "Als HTML-Datei ausgeben"
- "Als einseitiges HTML ausgeben"
- "Mach es zu HTML, damit der Leser es direkt öffnen kann"
Wenn du dich wohler fühlst, auf Englisch zu schreiben, ist "make a HTML file" oder "make a HTML artifact" in Ordnung. Das Ergebnis ist dasselbe.
Claude Code kann Kontext aus MCP, Browsern, Git und dem Dateisystem abrufen. Die Stärke von Claude Code ist, dass es viel breitere Informationsquellen in einem einzigen HTML bündeln kann als die Web-Chat-Versionen von ChatGPT oder Claude.ai.
Dies verbindet sich mit dem, was wir zuvor besprochen haben. Die Artifacts, die du in ChatGPT oder Claude.ai erhalten hast und die du für "schön" hieltest, wurden als HTML ausgegeben.
Du kannst jetzt dieselbe Welt auf der Claude Code-Seite empfangen. Es ist keine schwierige technische Geschichte; indem du eine Zeile in deiner Fragestellung änderst, kommen Materialien heraus, die die Menschen tatsächlich erreichen.
Thariq betont einen Punkt in seinem Artikel: "Ich möchte nicht, dass dies noch zu einem /html-Skill gemacht wird; ich möchte, dass sich die Menschen zuerst durch Prompts daran gewöhnen." Dies, obwohl er ein Entwickler im Claude Code-Team ist, der Skills produziert.
Er lehnt es nicht ab, es zu einem Skill zu machen. Er sagt: "Wenn du es verpackst, bevor die Nutzung gefestigt ist, wirst du die Teile verpassen, die wirklich effektiv sind."
Innerhalb von Anthropic werden HTML-Ausgaben, die häufig geworden sind, begonnen, in Dinge wie Playground-Plugins zu komponentisieren. Anstatt von Anfang an auf ein fertiges Produkt zu warten, probiere es zuerst mit einem einzeiligen Prompt, um das Muster zu finden, das zu deiner Arbeit passt. Erst wenn du diesen Punkt erreicht hast, solltest du dazu übergehen, es zu einem Skill zu machen.
"In jedem Prompt 'in HTML ausgeben' zu schreiben, mag wie eine Aufgabe erscheinen, aber die Wahl des Formats selbst ist keine Aufgabe. In dem Moment, in dem du von Claude, der Markdown ausgibt, zu Claude, der HTML ausgibt, wechselst, hast du einen halben Schritt in Richtung desjenigen gemacht, der 'die Ausgabe entwirft, bevor er auf einen vorgefertigten Skill wartet.'"
5 Geschäftsszenarien, die sich allein durch den Wechsel zu HTML ändern
Dieses Kapitel ist für die tatsächliche Arbeit von Montag bis Freitag wirksam. Ich habe die fünf Anwendungsfälle aus dem Originalartikel in der Reihenfolge ihrer Häufigkeit in der japanischen Geschäftswelt neu geordnet: Wochenberichte/Forschungszusammenfassungen, paralleler Vergleich von Vorschlägen, Design-Anpassungen, Entscheidungsfindungs-Bearbeitungsbildschirme und PR/Spezifikations-Reviews.
Jedes Szenario wird mit dem aktuellen Problem, Vorher/Nachher und schließlich einer Beispielanweisung für Claude Code zusammengefasst.
[Szenario 1] Lieferung von Wochenberichten und Forschungszusammenfassungen mit Diagrammen
Ein häufiges Vorkommnis in der japanischen Geschäftswelt. Montagmorgen fragt dein Chef: "Fass die Trends der letzten Woche zusammen."
Vorher: Du fügst 120 Zeilen Markdown in Slack ein. Zeilenumbrüche brechen. Dein Chef öffnet es nicht. Es wird nicht in die Materialien für das Management-Meeting aufgenommen. Du erklärst es mündlich und sagst: "Ich habe Claude es machen lassen."
Nachher: Du fasst es in einer einzigen HTML-Seite zusammen, die Slack-Protokolle, Linear- oder Notion-Ticketverlauf, Git-Protokolle und interne Dokumente einbezieht. Du fügst ein einfaches Geschäftsablaufdiagramm mit SVG ein und platzierst drei Kernpunkte in farbigen Blöcken am Ende.
Wenn du dies in den internen Speicher legst und die URL teilst, kann dein Chef es auf dem Weg zur Arbeit auf dem Handy öffnen, das Management kann es zitieren, und es kann in Meeting-Protokolle eingefügt werden.
Der Schlüssel hier ist, dass Claude Code Kontext aus MCP, Browsern, Git und dem Dateisystem abrufen kann. Selbst wenn du einen Web-Chat bittest, "ein HTML zu erstellen", ist es schwierig, so viele Informationsquellen in einem zu bündeln. Dies ist ein Wochenbericht, den nur Claude Code erstellen kann.
Thariq selbst schrieb, dass er die Diagramme für seine Artikel erstellt hat, indem er Claude Code alle HTML-Dateien in seinem Code-Ordner lesen ließ und sie auf einer Seite zusammenfasste. Ein "Wochenbericht, der gelesen wird" und ein "Diagramm für einen erklärenden Artikel, der gelesen wird" sind strukturell dasselbe.
▼ Beispielanweisung:
"Lies alle Slack-Interaktionen der letzten Woche, abgeschlossene Linear-Tickets und Git-Protokolle und gib einen Wochenbericht als einzelne HTML-Seite aus, den mein Chef in 1 Minute erfassen kann. Füge ein einfaches Geschäftsablaufdiagramm in SVG und drei Kernpunkte in farbigen Blöcken am Ende ein. Stelle sicher, dass es nicht bricht, wenn es auf einem Smartphone geöffnet wird."
[Szenario 2] 6 Vorschlags-/Recherche-Optionen nebeneinander zeigen
Welche Richtung sollen wir für den Vorschlag nächste Woche einschlagen? Eine häufige Szene in Planung, Vertrieb und Unternehmensplanung, in der mehrere Optionen erstellt und mit Entscheidungsträgern abgestimmt werden.
Vorher: Du sendest sechs Optionen in sechs separaten Markdown-Dateien. Der Kunde kann sie nicht einzeln öffnen und vergleichen. Er fragt: "Welche ist Ihre Top-Empfehlung?" und du stellst fest, dass du sie selbst nicht vollständig verglichen hattest.
Nachher: Du ordnest sechs Optionen mit unterschiedlichen Tönen, Dichten und Zielgruppen in einem Raster auf einer einzigen HTML-Seite an. Du fügst einen einzeiligen Kompromiss unter jede Option. Der Entscheidungsträger vergleicht sie alle auf einem Bildschirm und antwortet sofort: "Ich möchte dies und dies mischen" oder "Verwende das Ziel von #3 mit der Dichte von #1." Die Auflösung der Diskussion ändert sich in dem Moment, in dem du sie parallel zeigst.
Für einen Entscheidungsträger ist die Zeit, die für ein Urteil benötigt wird, Welten entfernt zwischen dem Erhalt von sechs Dateien und dem Anordnen von sechs Optionen auf einem Bildschirm. Es geht weniger darum, "sie zum Lesen zu bringen" als vielmehr darum, "ihnen zu ermöglichen, eine Entscheidung zu treffen."
▼ Beispielanweisung:
"Erstelle 6 Vorschlagsoptionen für die Präsentation nächste Woche mit unterschiedlichen Tönen, Dichten und Zielgruppen und ordne sie in einem Raster auf einer einzigen HTML-Seite an. Schreibe einen einzeiligen Kompromiss unter jede Option. Füge außerdem einen Button am Ende hinzu, um das Ergebnis als Markdown zu kopieren, sobald eine Entscheidung getroffen wurde."
[Szenario 3] Entscheidung über Designs und Prototypen durch Anfassen
Bei der Entscheidung über Farben, Größen oder Bewegungen solltest du aufgeben, sie durch Text abzustimmen. Dies ist eine Szene, in der Marketing, PR und Planung viele Male über Dankes-E-Mails oder Landing-Page-Buttons hin und her gehen.
Vorher: Du kommunizierst mit Worten wie "ein etwas ruhigeres Blau" oder "mach die Bewegung fluffig." Das Bild des Empfängers weicht jedes Mal ab. Beim Blick auf die Version, die nach einer Runde zurückkommt, fügst du weitere Worte hinzu: "Nein, nicht diese Art von Ruhe."
Nachher: Du lässt Claude Code ein HTML erstellen, in dem du Schieberegler für Farbe und Animationsgeschwindigkeit bewegen kannst. Du erstellst Prototypen für Dankes-E-Mail-Buttons oder LP-CTA-Buttons als einzelne HTML-Seiten und sendest die URL an die Stakeholder. Jeder berührt sie, entscheidet sich für die besten Werte und kopiert diese Werte einfach zurück zu Claude. Text-Hin und Her nimmt ab, und die Zeit bis zur Einigung verkürzt sich.
In diesem Zusammenhang beginnt Anthropic Labs, dieses Konzept des "Berührens, um zu entscheiden, und Kopierens der Operation zurück zu Claude" als Playground-Plugin zu formalisieren. HTML-Ausgabe ist nicht nur ein kleiner Trick; es ist eine Richtung, die Anthropic selbst als Muster fördert.
▼ Beispielanweisung:
"Erstelle ein HTML, in dem ich die Farbe und Animationsgeschwindigkeit des Buttons in der Dankes-E-Mail mit drei Arten von Schiebereglern festlegen kann. Füge einen Button am Ende hinzu, um die festgelegten Werte zu kopieren."
[Szenario 4] In 3 Minuten einen Entscheidungsbildschirm erstellen
Welche Maßnahmen sollten für das nächste Quartal Now, Next, Later oder Cut zugewiesen werden? Das Sortieren von 30 Tickets, um Prioritäten zu entscheiden, ist eine typische "Entscheidungsaufgabe" für PdMs, Planer und Unternehmensplaner.
Vorher: Du ordnest 30 Elemente in einer Tabelle an und füllst die Prioritätsspalte manuell nacheinander aus. Du sortierst, denkst neu, verschiebst in ein anderes Blatt und verschiebst zurück. An manchen Tagen verbringst du 30 Minuten und hast immer noch kein Ergebnis.
Nachher: Du bittest Claude Code, "ein HTML zu erstellen, in dem ich Elemente per Drag & Drop in vier Spalten ziehen kann: Now, Next, Later und Cut." Ein dedizierter Bearbeitungsbildschirm ist in 3 Minuten fertig. Du ziehst die 30 Karten, und wenn du fertig bist, kopierst du die Ergebnisse. Die Zeit für Entscheidungsaufgaben verkürzt sich um eine Größenordnung.
Es gibt ein Designprinzip, das leicht übersehen wird, aber sehr effektiv ist. Es ist der Satz, in dem Thariq schreibt: "Immer mit einem Export enden." Wenn du einen Bearbeitungsbildschirm erstellst, füge immer Buttons für "Als JSON kopieren", "Als Prompt kopieren" oder "Als Markdown kopieren" hinzu.
Ohne dies kannst du die Ergebnisse deiner Sortierung nicht an Claude zurückgeben, und es endet als reines Aufgaben-Tool. Ein Bearbeitungsbildschirm wird nur dann zu einem Entscheidungsgerät, wenn du eine Schleife erstellst: im HTML entscheiden, dann das strukturierte Textergebnis an Claude zurückgeben.
Dieselbe Idee kann für die Bearbeitung von Feature-Flags, Side-by-Side-System-Prompt-Editoren oder Dataset-Approval/Reject/Tagging verwendet werden. "In 3 Minuten eine dedizierte, wegwerfbare UI erstellen" ist der Ort, an dem der wahre Wert von Claude Code am deutlichsten sichtbar wird.
▼ Beispielanweisung:
"Erstelle ein HTML, in dem ich 30 Maßnahmen für das nächste Quartal per Drag & Drop in vier Spalten ziehen kann: Now, Next, Later und Cut. Platziere am Ende einen 'Als Markdown kopieren'-Button, damit ich die Sortierergebnisse mit Gründen für jede Zeile ausgeben kann."
[Szenario 5] Übergabe von PR-Reviews und Spezifikationsfreigabe mit farbcodierten Diffs
Schließlich ein Szenario für die Zusammenarbeit mit Ingenieuren. Selbst wenn du keinen Code liest, könntest du als PdM, Direktor oder Redakteur für PR-Reviews oder Spezifikationsbestätigungen hinzugezogen werden.
Vorher: Du wirst gebeten, den GitHub-Diff-Bildschirm zu öffnen. Du kannst nicht erkennen, welcher Teil des Diffs wichtig ist und welcher ignoriert werden kann, nur durch Anschauen. Du musst die Kommentare lesen, um der Geschichte zu folgen. Menschen, die keinen Code lesen, sagen oft nur "lass mich wissen, wenn es etwas gibt" und schließen es.
Nachher: Du bittest Claude Code, "diesen PR in ein HTML-Review-Dokument zu verwandeln, das jemand, der keinen Code liest, in 30 Sekunden erfassen kann." Kommentare werden neben den Diffs angebracht, der Umfang der Auswirkungen wird farbcodiert, und eine Zusammenfassung von drei Bedenken wird am Ende bereitgestellt. Wenn du dies in den internen Speicher hochlädst und die URL teilst, können PdMs und Direktoren mit einem Button Feedback geben. Diejenigen, die mit Ingenieuren zusammenarbeiten, können endlich an Reviews teilnehmen.
HTML ist keine Sprache für Ingenieure; es ist ein Werkzeug, um eine Geschichte zu liefern. Die Bedeutung des Diffs, die Risiken und der Umfang der Auswirkungen – diese "Informationen, die Entschlüsselung erfordern" – werden mit Anmerkungen, Farbe und Layout geliefert. Das ist die Bedeutung der HTML-Konvertierung.
▼ Beispielanweisung:
"Verwandle diesen PR in ein HTML-Review-Dokument, das jemand, der keinen Code liest, in 30 Sekunden erfassen kann. Bringe Kommentare neben den Diffs an, zeige den Umfang der Auswirkungen mit Farbcodierung und fasse drei Bedenken am Ende zusammen."
Während du weiterhin in Markdown für diese fünf Szenarien ausgibst, sammelt sich die Formatsteuer leise, aber täglich an. Ob du sie in dem Moment stoppst, in dem du sie bemerkst, wird der Unterschied ab nächster Woche sein.
6 Fragen, die beim Wechsel auftauchen
Beim Lesen kommen dir wahrscheinlich mehrere Fragen in den Sinn. Ich habe den FAQ-Abschnitt aus dem Originalartikel in der Reihenfolge neu geordnet, in der japanische Geschäftsleser wahrscheinlich darauf stoßen.
■ Verbraucht es mehr Tokens?
Ja, das tut es. Der Originalartikel gibt an, dass die Generierung 2-4 mal länger dauert als bei Markdown. Allerdings hat Opus 4.7 einen 1M-Token-Kontext, sodass das Risiko von Gesprächsabbrüchen aufgrund von Kontextlimits durch die Rückgabe von HTML praktisch verschwunden ist.
Thariqs Schlussfolgerung ist: "Die Zahlen steigen, aber wenn du das Ergebnis wählst, das gelesen wird, zahlt es sich für die gesamte Arbeit aus." Es ist eine Wahl, ob du deinen über 3.000 Yen teuren Monatsvertrag für 1.000 Zeilen ungelesenen Markdowns oder eine Seite HTML, die geöffnet wird, verwendest.
■ Wird das Design nicht hässlich sein?
Dies ist eine berechtigte Sorge, aber es gibt Gegenmaßnahmen.
Eine ist die Verwendung von Frontend-Design-Plugins von Claude Code. Eine andere ist, Claude ein Beispiel-HTML von der Website deines Unternehmens oder vorhandenen Materialien zur Verfügung zu stellen. Wenn du eine Referenzdatei bereitstellst und sagst "in diesem Ton" oder "mit dieser Schriftart und Palette", wird Claude HTML ausgeben, das zum Look deines Unternehmens passt. Das Aufbewahren einer Datei wie design-system.html in deiner Codebasis ermöglicht es dir, jedes Mal darauf zu verweisen.
■ Ist das Bearbeiten von HTML nicht umständlich?
Du musst es nicht selbst bearbeiten.
Thariq selbst schreibt, dass er das HTML nicht direkt anfasst. Wenn du Claude sagst: "Beruhige diese Farbe etwas" oder "Mach den dritten Abschnitt etwas kleiner", wird es es für dich reparieren. Solange du es für Spezifikationen, Brainstorming oder Referenzmaterialien verwendest, kannst du die gesamte Bearbeitung Claude überlassen.
■ Wie öffne ich es? Wie teile ich es?
Das Öffnen ist einfach. Öffne einfach die HTML-Datei, die Claude Code lokal produziert hat, in deinem Browser.
Du kannst Claude sogar bitten, "diese Datei zu öffnen", und es könnte sie für dich in deinem Browser öffnen. Beim Teilen ist der einfachste Weg, sie in den internen Speicher oder auf S3 hochzuladen und die URL bereitzustellen. Wenn du den Link in Slack oder E-Mail einfügst, kann der Empfänger sie in seinem Browser öffnen. Dieser zusätzliche Schritt der Konvertierung von Markdown in PDF verschwindet vollständig.
■ Was ist mit der Versionskontrolle?
Um ehrlich zu sein, ist HTML nicht sehr geeignet für Git-Diff-Management. Das Beheben einer Zeile könnte Diffs aufgrund von Formatierungseinstellungen an andere Stellen verschieben. Thariq selbst schreibt, dass HTML die größte Schwäche der Versionskontrolle ist.
Deshalb ist die praktische Lösung: "Liefergegenstände für Menschen" sind HTML, und "Spezifikationen oder Aufzeichnungen, deren Verlauf du behalten möchtest" sind Markdown. Es geht nicht darum, Markdown abzuschaffen, sondern darum, zu einer Denkweise zu wechseln, das Format basierend auf dem Zweck der Ausgabe zu wählen.
■ Kann ich ganz aufhören, Markdown zu verwenden?
Nein. Aufzeichnungen, Änderungsverläufe und strukturierter Text, den du im Repository behalten möchtest, sollten als Markdown bleiben.
CLAUDE.md und SKILL.md sind einfacher zu verwalten und Diffs zu verfolgen, wenn sie als Markdown bleiben. HTML eignet sich für "die Lieferung an Menschen", "das Anfassen durch Menschen", "das Nebeneinanderstellen mehrerer Optionen" und "das Ermöglichen von Entscheidungen mit Farbe." Wenn du es grob verstehst als "Markdown für die Interaktion mit KI, HTML für die Verteilung an Menschen", wirst du nicht verloren gehen.
Bis jetzt sollten deine anfänglichen Zweifel ausgeräumt sein. Ein Artikel, der Nachteile enthält, ist vertrauenswürdiger – das ist meine Überzeugung als Autor.
Wirst du weiterhin die Formatsteuer zahlen oder auf die Design-Seite wechseln?
Abschließend lass uns die Perspektive erhöhen, um abzuschließen.
Wir haben bereits über die „Prompt Tax“ gesprochen – die Kosten, die entstehen, wenn man Claude immer wieder dieselben Prämissen eintippt. Dann kam die Geschichte über den Wechsel zur Design-Ebene mit dem .claude-Ordner. Diese „Format Tax“ ist das dritte Thema in dieser Reihe. Nach der Gesprächsebene und der Design-Ebene haben wir uns nun der Ausgabeebene zugewandt.
Lass uns „Format Tax“ so definieren, dass wir es mit den Lesern teilen können:
Wenn du immer wieder Ausgabeformate wählst, die nicht gelesen werden, baut sich bei dir und anderen schon vor dem Öffnen Ermüdung auf. Du zahlst über 3.000 Yen im Monat für Claude Code, aber die Ergebnisse werden nie in Meetings verwendet. Dieses Gefühl entsteht, weil du keine Entscheidung bei der Formatwahl triffst. Das ist die Format Tax.
Die Ausgabe in Markdown ist eine Aufgabe. Die Wahl von HTML ist eine Entscheidung. Selbst mit demselben Claude Code verändert eine einzige Entscheidung bei der Formatwahl die Reichweite deiner Ergebnisse erheblich.
Und HTML ist keine Sprache für Ingenieure. Es ist ein Werkzeug, um Materialien zu erstellen, die gelesen werden. Leg den Gedanken, eine Website zu bauen, für einen Moment beiseite. Versuch einfach, den Wochenbericht, den Vorschlag oder das Review-Dokument, das du diese Woche schreibst, in HTML auszugeben. Das reicht völlig.
Lass uns über das große Ganze sprechen.
Die Ära, in der Markdown der implizite Standard der KI-Branche war, geht innerhalb von Anthropic leise zu Ende. Während CLAUDE.md, SKILL.md und Cursor-Regeln alle auf einer Markdown-Prämisse aufbauten, beginnt das Ausgabeformat als erstes zu wechseln. Leser, die den Moment des Standardwechsels miterleben, können einen halben Schritt voraus sein.
Natürlich kannst du, sobald du merkst: „Das mache ich jede Woche“, dich dafür entscheiden, es zu einer Skill weiterzuentwickeln.
Innerhalb von Anthropic werden Muster mit hoher Frequenz für HTML-Ausgaben, wie designbezogene Playgrounds, nach und nach als Komponenten gepflegt. Für die erste Woche reicht jedoch ein einzeiliger Prompt. Versuch heute Abend, nur einen Wochenbericht in HTML auszugeben. Nächste Woche versuch, sechs Vorschlagsoptionen in einem einzigen Raster anzuordnen. Fang damit an, und die Format Tax wird leise zu sinken beginnen.
Thariq selbst schreibt am Ende seines Artikels: „Ich hatte Angst davor, das tiefe Lesen von Markdown einzustellen und die Entscheidungen vollständig Claude zu überlassen. Seit ich auf HTML umgestiegen bin, habe ich das Gefühl, wieder mehr im Loop mit Claude zu sein, und vor allem macht es einfach Spaß, etwas zu erschaffen.“
Die Wahl eines Formats ist ein Schalter, um die Initiative bei der Arbeit mit KI zurückzugewinnen, und gleichzeitig ein Schalter, um ein wenig mehr Hitze in deinen Arbeitsalltag zu bringen.
Wirst du weiterhin ungelesenes Markdown produzieren, oder wechselst du auf die Seite, die das Format wählt? Die nächste Woche wird die Grenze sein.
Zusammenfassung
- Der Entwickler, der Claude Code bei Anthropic baut, hat erklärt, dass er Markdown nicht mehr verwendet. Die Einführung von HTML verbreitet sich innerhalb des internen Teams.
- Bisher war Markdown der implizite Standard für KI – von Claude Code und Cursor über GitHub Copilot, Cline, interne Wikis und ChatGPT-Ausgaben. Der Schöpfer hat diesen Industriestandard nun in Frage gestellt.
- Es gibt 5 Gründe, warum Markdown nicht gelesen wird: bei 100 Zeilen nicht mehr überfliegbar / bricht beim Teilen / keine Farben oder Diagramme / nicht anfassbar, um zu beurteilen / bricht auf Mobilgeräten. Diese versteckten Kosten sind die „Format Tax“.
- Zum Wechseln reicht eine Zeile: „Als HTML-Datei ausgeben.“ Eine Skill daraus zu machen, kann warten, bis die Nutzung gefestigt ist.
- 5 geschäftliche Szenarien – Wochenberichte, parallele Vorschläge, Design-Anpassungen, Entscheidungsbildschirme und PR-Reviews – verwandeln sich allein durch den Wechsel zu HTML in Materialien, die geöffnet, beurteilt und zurückgegeben werden.
- Ein Format zu wählen ist eine Entscheidung, keine Aufgabe. Die Ausgabe in Markdown ist eine Aufgabe; die Wahl von HTML ist eine Entscheidung. Der Unterschied zwischen Claude-Code-Nutzern tut sich hier auf.
Für diejenigen, die diesen Artikel hilfreich fanden:
Das Claude Code Laboratory der Universität Tokio (@ClaudeCode_UT) ist ein Account, der ernsthaft von einem Team von UTokyo-Studenten betrieben wird. Wir arbeiten auch an gemeinsamen Claude-Code-Geschäftsentwicklungen mit großen Unternehmen und teilen nur Designs und Know-how, die in der Praxis tatsächlich funktionieren.
Wir liefern täglich „wirklich nützliche“ Informationen und Know-how, spezialisiert auf praktische Arbeit 👇
■ Kostenlose Veröffentlichung von Claude-Code-Skills, die in der Praxis einsetzbar sind
■ Übersetzung und Neustrukturierung primärer KI-Informationen aus dem Ausland in einen japanischen Geschäftskontext
■ Dies ist der einzige Ort, an dem du Skills und Tools, die ernsthaft vom UTokyo-Team entwickelt wurden und „wirklich nützlich“ sind, kostenlos erhältst ❗️
Wenn du interessiert bist, folge uns und schau vorbei.
LINE ist hier ⇩
