gik|iewicz

Thariq Shihipar z zespołu Claude Code w Anthropic opublikował tekst, który wywołał burzę w społeczności programistów. Jego teza jest prosta: prośba o HTML zamiast Markdown daje lepsze rezultaty w Claude Code. Simon Willison określił ten materiał jako „thought-provoking piece” – i ma rację.

TL;DR: Thariq Shihipar z zespołu Claude Code w Anthropic udowodnił, że prośba o format HTML zamiast Markdown znacząco poprawia jakość generowanego kodu. HTML wymusza na modelu językowym bardziej ustrukturyzowane myślenie, co przekłada się na lepsze rezultaty w Claude Code. Simon Willison opisał to jako „thought-provoking piece”.

Dlaczego HTML działa lepiej niż Markdown w Claude Code?

Thariq Shihipar z zespołu Claude Code w Anthropic opublikował analizę porównującą format HTML i Markdown jako format wyjściowy dla modelu. Jego wnioski są jednoznaczne – HTML wymusza na modelu bardziej rygorystyczne podejście do struktury dokumentu. Simon Willison skomentował ten materiał jako „crammed with” praktycznymi przykładami, które potwierdzają tę tezę.

Kluczowa różnica polega na tym, że HTML wymaga domykania tagów, definiowania atrybutów i przestrzegania hierarchii. Markdown pozwala na luźniejsze formatowanie, co daje modelowi więcej swobody – ale ta swoboda często przekłada się na mniej precyzyjne wyniki. W przeglądzie Claude Code opisywałem już, jak formatowanie wpływa na jakość odpowiedzi.

Otóż HTML zmusza Claude do jawnego deklarowania intencji. Każdy element musi mieć otwarcie i zamknięcie. Każda klasa musi być przypisana. Ta sztywność formatu wymusza bardziej przemyślane generowanie treści.

Jak HTML wymusza lepsze myślenie u modelu?

Zgodnie z analizą Shihipara, format HTML działa jak swoisty „cognitive scaffold” dla modelu językowego. Model musi przemyśleć strukturę zanim wygeneruje treść. W Markdown wystarczy napisać nagłówek z hashem – w HTML trzeba otworzyć tag, przypisać atrybuty, zamknąć tag.

To ma bezpośrednie przełożenie na jakość kodu generowanego przez Claude Code. Shihipar pokazuje, że prosząc o HTML, otrzymujesz bardziej kompletne rozwiązania z mniejszą liczbą błędów logicznych. Z kolei Markdown często prowadzi do niepełnych odpowiedzi lub pominięcia istotnych detali.

Przykładowo, gdy prosisz Claude o wygenerowanie dokumentacji w HTML, model musi przemyśleć hierarchię sekcji, nawigację i dostępność. W Markdown te aspekty często są pomijane, bo format na to pozwala.

Jakie są praktyczne różnice między HTML a Markdown?

Analiza Shihipara zawiera konkretne przykłady pokazujące różnice w jakości odpowiedzi. Oto zestawienie kluczowych aspektów obu formatów:

• HTML wymaga jawnej deklaracji struktury dokumentu przez tagi
• Markdown pozwala na luźne formatowanie bez ścisłej hierarchii
• HTML wymusza domknięcie wszystkich elementów i przypisanie atrybutów
• Markdown akceptuje niedomknięte nagłówki, listy i bloki kodu
• HTML ułatwia modelowi zachowanie spójności między sekcjami
• Markdown pozwala na niespójne zagnieżdżenie elementów
• HTML wymaga przemyślenia relacji między elementami przed generowaniem
• Markdown daje modelowi swobodę, która często prowadzi do pominięć

Jak zastosować tę technikę w Claude Code?

W praktyce wystarczy dodać do promptu instrukcję o formatowanie odpowiedzi w HTML. Shihipar zaleca proste polecenia typu „odpowiedz w HTML” lub „użyj formatu HTML dla dokumentacji”. Ta drobna zmiana w prompcie daje mierzalne efekty.

W szybkim starcie Claude Code znajdziesz podstawy konfiguracji narzędzia. Dodanie preferencji HTML do pliku CLAUDE.md lub do promptu systemowego to krok dalej. Możesz też użyć darmowego sposobu na korzystanie z Claude Code i przetestować tę technikę bez kosztów.

Zatem implementacja jest prosta. Nie trzeba instalować dodatkowych narzędzi ani zmieniać konfigurację. Wystarczy zmienić sposób formułowania poleceń do Claude.

Kiedy HTML daje największe przewagi nad Markdownem?

Analiza Shihipara wskazuje, że HTML sprawdza się najlepiej w zadaniach wymagających precyzyjnej struktury dokumentu. Prośba o format HTML w Claude Code redukuje ryzyko pominięć w generowanym kodzie. Simon Willison określił oryginalny materiał jako pełen praktycznych przykładów potwierdzających tę zależność.

Zatem HTML jest szczególnie użyteczny przy tworzeniu dokumentacji technicznej, raportów i interfejsów. W tych scenariuszach sztywna struktura tagów wymusza na modelu przemyślenie hierarchii informacji. Markdown pozostaje odpowiedni dla notatek czy krótkich podsumowań, gdzie formalna struktura nie jest priorytetem.

W dzienniku zmian Claude Code można sprawdzinić, jak ewoluowało podejście modelu do różnych formatów wyjściowych. Co więcej, Anthropic dodaje rutyny do Claude Code, co rozszerza możliwości automatyzacji zadań wymagających precyzyjnych odpowiedzi.

Jakie błędy w kodzie redukuje format HTML?

Shihipar z zespołu Claude Code udokumentował, że proszenie o HTML zmniejsza częstotliwość błędów strukturalnych w generowanych odpowiedziach. Model językowy musi domknąć każdy tag i zachować poprawne zagnieżdżenie. Markdown nie wymusza takiej dyscypliny, co prowadzi do luk w wygenerowanym kodzie.

• Pominięte sekcje dokumentacji wynikające z luźnej struktury Markdown
• Niespójne zagnieżdżenie elementów list i nagłówków
• Brak domknięcia bloków kodu i definicji tabel
• Niekompletne odpowiedzi spowodowane brakiem wymogu jawnej deklaracji struktury
• Pominięte atrybuty dostępności i semantyczne znaczniki
• Niespójne formatowanie między powiązanymi sekcjami dokumentu

Powyższa lista ilustruje typowe problemy, które HTML pomaga wyeliminować poprzez wymóg ścisłej deklaracji struktury.

Jakie są ograniczenia techniki HTML w Claude Code?

Technika proszenia o HTML nie jest uniwersalnym rozwiązaniem. Shihipar zaznacza, że dla prostych zapytań – takich jak krótkie wyjaśnienia czy jednozdaniowe odpowiedzi – format wyjściowy nie ma istotnego wpływu na jakość. Kosztem jest dłuższy czas generowania odpowiedzi, ponieważ model musi przetworzyć więcej tokenów na strukturę dokumentu.

Choć HTML poprawia jakość złożonych odpowiedzi, zwiększa zużycie tokenów. W pomiarze kosztów tokenizera Claude 4.7 opisywałem mechanizmy optymalizacji wydatków na API. Tagi HTML dodają narzut, który przy tysiącach zapytań może się sumować.

Mimo to, dla zadań wymagających precyzji, ten narzut jest uzasadniony. Jak pokazuje przegląd Claude Code, model radzi sobie z HTML wystarczająco dobrze, by korzyści przewyższyły koszty dodatkowych tokenów.

Jak HTML wpływa na generowanie interfejsów użytkownika?

Shihipar podkreśla, że HTML jest formatem naturalnym dla generowania komponentów interfejsu. Claude Code, proszony o HTML, tworzy bardziej kompletne szablony z uwzględnieniem dostępności, responsywności i semantyki. W Anthropic presents Claude Design znajdziesz informacje o podejściu Anthropic do projektowania interfejsów.

Ponadto, gdy Claude generuje kod HTML, automatycznie uwzględnia atrybuty ARIA, role semantyczne i strukturę nagłówków. W Markdown te elementy po prostu nie istnieją – format nie posiada mechanizmów do ich wyrażenia.

W rezultacie, prosząc o HTML przy tworzeniu interfejsów, otrzymujesz kod gotowy do integracji z frameworkami frontendowymi. Markdown wymagałby dodatkowej konwersji, co wprowadza kolejny etap potencjalnych błędów.

Jak zoptymalizować prompty dla formatu HTML?

Shihipar zaleca stosowanie precyzyjnych instrukcji określających oczekiwaną strukturę HTML. Zamiast ogólnego „odpowiedz w HTML”, lepiej określić konkretne tagi, klasy i atrybuty. W claude code /ultraplan opisywałem zaawansowane techniki planowania promptów dla Claude Code.

Oto kluczowe zalecenia z analizy Shihipara:

• Określ docelowy standard HTML (HTML5, XHTML) w prompcie
• Wymień wymagane atrybuty dostępności (aria-label, role)
• Zdefiniuj oczekiwaną strukturę nagłówków (h1, h2, h3)
• Wskaż preferowane klasy CSS i konwencje nazewnictwa
• Dodaj instrukcje dotyczące responsywności i meta tagów
• Wymuś semantyczne tagi (nav, main, article, section)

Dlatego im bardziej precyzyjny prompt, tym lepsze rezultaty. Shihipar pokazuje, że szczegółowe instrukcje strukturalne dają wymierne efekty w jakości generowanego kodu.

Jak HTML wpływa na kontekst i spójność długich odpowiedzi?

Długie odpowiedzi w Markdown często tracą spójność – model gubi wątki, pomija sekcje lub niespójnie formatuje elementy. Shihipar udokumentował, że HTML rozwiązuje ten problem. Otwarte tagi przypominają modelowi o konieczności domknięcia sekcji, co naturalnie wymusza kompletność.

Z kolei Markdown pozwala na nagłe zakończenie odpowiedzi bez formalnego domknięcia struktury. W Claude myli, kto co powiedział opisywałem problemy ze spójnością kontekstu u modeli językowych. HTML stanowi częściowe rozwiązanie tego problemu na poziomie formatowania.

Co więcej, tagi HTML tworzą widoczną mapę odpowiedzi. Model „widzi” otwarte elementy i ma silniejszą motywację do ich domknięcia. To zmniejsza ryzyko uciętych lub niekompletnych odpowiedzi.

Jakie są przykłady zastosowań z analizy Shihipara?

Shihipar opisuje konkretne scenariusze, w których HTML znacząco przewyższa Markdown. Simon Willison podkreśla, że artykuł jest pełen praktycznych przykładów. Oto kluczowe zastosowania udokumentowane w analizie:

• Dokumentacja API z precyzyjną strukturą nagłówków i sekcji
• Raporty analizy danych z tabelami, wykresami i podsumowaniami
• Szablony komponentów interfejsu z atrybutami dostępności
• Dokumentacja architektury systemu z diagramami i opisami powiązań
• Plany projektowe z hierarchią zadań i zależnościami

Na przykład, przy generowaniu dokumentacji API, HTML pozwala stworzyć spójną nawigację, nagłówki z identyfikatorami i tabelę z opisami endpointów. Markdown teoretycznie umożliwia to samo, ale w praktyce często prowadzi do pominięć.

Często zadawane pytania

Czy HTML zawsze daje lepsze rezultaty niż Markdown w Claude Code?

Nie. Shihipar wskazuje, że dla krótkich, prostych zapytań format nie ma istotnego wpływu na jakość. HTML przewyższa Markdown przy zadaniach wymagających rozbudowanej struktury – dokumentacji powyżej kilku sekcji, raportów i szablonów interfejsów. Dla jednozdaniowych odpowiedzi różnica jest pomijalna.

Czy technika HTML zwiększa zużycie tokenów w Claude Code?

Tak. Tagi HTML dodają narzut tokenów w porównaniu z minimalistycznym Markdownem. Shihipar potwierdza, że korzyści z lepszej struktury przewyższają koszty dodatkowych tokenów przy złożonych zadaniach. Przy prostych zapytaniach narzut ten nie jest uzasadniony.

Jak szybko wdrożyć technikę HTML w Claude Code?

Wystarczy dodać instrukcję „odpowiedz w HTML” do promptu. Shihipar zaleca również określenie konkretnych tagów i atrybutów dla lepszych rezultatów. Nie jest wymagana zmiana konfiguracji Claude Code ani instalacja dodatkowych narzędzi. Istnieje darmowy sposób na korzystanie z Claude Code, który pozwala przetestować tę technikę bez kosztów.

Czy HTML rozwiązuje problemy ze spójnością kontekstu u Claude?

Częściowo. Shihipar pokazuje, że otwarte tagi HTML przypominają modelowi o konieczności domknięcia struktury, co zmniejsza ryzyko niekompletnych odpowiedzi. Nie rozwiązuje to jednak wszystkich problemów z kontekstem opisanych w dokumentacji Claude Code.

Podsumowanie

Analiza Shihipara z zespołem Claude Code dostarcza konkretnych dowodów na przewagę HTML nad Markdownem jako formatem wyjściowym dla Claude. Kluczowe wnioski z materiału:

• HTML wymusza na modelu rygorystyczne podejście do struktury, co redukuje błędy i pominięcia
• Technika jest prosta w implementacji – wystarczy dodać instrukcję do promptu
• Największe korzyści pojawiają się przy złożonych zadaniach: dokumentacji, raportach, interfejsach
• Narzut tokenów jest akceptowalny przy zadaniach wymagających precyzji
• Precyzyjne instrukcje dotyczące struktury HTML dają lepsze rezultaty niż ogólne polecenia

Przetestuj tę technikę w swoim kolejnym projekcie z Claude Code. Dodaj „odpowiedz w HTML” do promptu przy generowaniu dokumentacji lub interfejsu i porównaj rezultaty z formatem Markdown. Różnica może być zaskakująca.