Kurs vibe coding z Claude Code · Moduł 5: Klon Reddita
Pergaminy załogi: Markdown w postach bez przemytu skryptów
W tej lekcji9
Polly chce w poście wypunktować zapasy na rejs, a Redbeard pogrubić ostrzeżenie przed Krakenem. Pole treści przyjmuje jednak tylko zwykły tekst, więc ich posty wyglądają jak jeden długi akapit. Najprostsza furtka to wpuścić do postów HTML, ale wtedy każdy pirat mógłby wkleić skrypt, który wykona się w przeglądarce całej załogi. W tej lekcji Claude Code doda formatowanie tak, żeby furtka została zamknięta, a test sprawdzi, czy naprawdę jest.
Problem: formatowanie bez furtki
Markdown to prosty zapis formatowania zwykłymi znakami. Krzyżyki na początku linii robią nagłówek, myślnik punkt listy, dwie gwiazdki z każdej strony pogrubienie, a nawiasy kwadratowe i okrągłe link. Tak wygląda post Polly:
## Zapasy na rejs
**Uwaga:** przy Zatoce Mgieł widziano Krakena.
- beczka wody
- suchary
[Mapa portu](https://example.com/tortuga)Pogrubienie to trzy części w jednej linii: **, tekst i znowu **. Taki tekst zapisujesz jak każdy inny, a zamieniasz go na nagłówki i listy dopiero przy wyświetlaniu. Właśnie tam czeka pułapka. Wiele bibliotek zamienia Markdown na gotowy tekst HTML, który trzeba wstawić przez dangerouslySetInnerHTML. Zasadę znasz z lekcji 3_3: treści od użytkowników nigdy nie wyświetlasz przez dangerouslySetInnerHTML. Potrzebujesz więc narzędzia, które z Markdownu zbuduje elementy React, a nie tekst HTML.
Polecenie dla Claude Code
Bibliotekę wskazujesz w poleceniu sam, bo to decyzja o bezpieczeństwie, a nie o wygodzie. react-markdown według swojej dokumentacji jest bezpieczna domyślnie: buduje drzewo elementów React, nie używa dangerouslySetInnerHTML i nie wykonuje HTML z treści.
Polecenie dla Claude Code:
Dodaj Markdown do treści postów Crew Council: nagłówki, pogrubienie,
listy i linki. Treść piszą użytkownicy, więc renderuj ją biblioteką
react-markdown, bez dangerouslySetInnerHTML i bez surowego HTML.
Jeden komponent components/PostBody.tsx dla karty posta i strony posta.
Style: klasa prose z @tailwindcss/typography (Tailwind 4, @plugin
w @app/globals.css). Najpierw testy w components/PostBody.test.tsx:
Markdown daje nagłówek, pogrubienie i listę; tekst <img src="x"
onerror="alert(1)"> nie tworzy obrazka; link javascript: traci adres.
Nie dodawaj innych paczek. Na koniec testy, lint i build, pokaż wynik.Zdanie o innych paczkach nie jest ozdobą. Każda paczka to cudzy kod w Twoim projekcie, a Claude chętnie dokłada "przy okazji" kolorowanie kodu albo obsługę HTML.
Co zrobił Claude: dwie paczki
Otwórz w Cursorze panel Source Control i kliknij package.json. W dependencies przybyła jedna linia:
"dependencies": {
"next": "16.4.6",
"react": "19.3.0",
"react-dom": "19.3.0",
"react-markdown": "^10.1.0"
},dependencies to paczki potrzebne aplikacji w działaniu. Druga paczka, "@tailwindcss/typography": "^0.5.20", trafiła do devDependencies, bo jest potrzebna tylko przy budowaniu stylów (wersje to stan na listopad 2026). Daszek ^ pozwala npm instalować nowsze wydania bez zmian łamiących zgodność. Nie ma tu marked, rehype-raw ani dompurify: dokładnie dwie paczki, o które prosiłeś. W app/globals.css doszła linia pod importem Tailwinda:
@import "tailwindcss";
@plugin "@tailwindcss/typography";@plugin to sposób Tailwinda 4 na wtyczki. Plik tailwind.config.js z require(...) to droga Tailwinda 3, którą dokumentacja wtyczki opisuje już tylko dla starszych projektów.
Co napisał Claude: PostBody
Otwórz components/PostBody.tsx:
import ReactMarkdown from "react-markdown";
export default function PostBody({ content }: { content: string }) {
return (
<div className="prose prose-sm max-w-none prose-a:text-blue-600">
<ReactMarkdown>{content}</ReactMarkdown>
</div>
);
}ReactMarkdown dostaje tekst posta jako dziecko i zwraca zwykłe elementy React: h2, strong, ul, a. Klasy stoją na otaczającym div, bo obecna wersja biblioteki nie przyjmuje propa className. prose nadaje nagłówkom rozmiar, a listom kropki, prose-sm zmniejsza tekst do rozmiaru karty, max-w-none zdejmuje limit szerokości, który prose ustawia dla wygody czytania, a prose-a:text-blue-600 koloruje tylko linki. Komponent nie ma "use client", więc działa i na stronie posta, i w karcie wewnątrz Feed. Karta i strona posta pokazują teraz treść przez <PostBody content={post.content} />.
Co napisał Claude: test, który pilnuje furtki
Otwórz components/PostBody.test.tsx. render z Testing Library, którą Claude zainstalował w lekcji 4_1, rysuje komponent w udawanej przeglądarce, a container to element, w którym wylądował wynik. Dwa przypadki pilnują bezpieczeństwa:
it("nie wstawia HTML z treści posta", () => {
const { container } = render(<PostBody content={'<img src="x" onerror="alert(1)">'} />);
expect(container.querySelector("img")).toBeNull();
});
it("nie przepuszcza linku javascript:", () => {
const { container } = render(<PostBody content="[mapa](javascript:alert(1))" />);
expect(container.querySelector("a")?.getAttribute("href")).toBe("");
});querySelector zwraca pierwszy element pasujący do selektora CSS albo null, a toBeNull oczekuje, że takiego elementu nie ma. onerror to kod, który przeglądarka uruchamia, gdy obrazek się nie wczyta, więc taki znacznik wystarczy do ataku. react-markdown pokazuje go jako zwykły napis. Link javascript: uruchamia kod po kliknięciu, dlatego biblioteka przepuszcza tylko bezpieczne rodzaje adresów, jak https i mailto, a resztę zamienia na pusty adres. Pierwszy test w pliku sprawdza samo formatowanie: nagłówek, pogrubienie i dwa punkty listy.
Sprawdzian sprawdzianu
Test, który przechodzi zawsze, niczego nie pilnuje. Sprawdziliśmy więc wersję, którą agenci lubią pisać: biblioteka marked zamienia Markdown na tekst HTML, a komponent wstawia go przez dangerouslySetInnerHTML. Oto środek wyniku:
❯ components/PostBody.test.tsx (3 tests | 2 failed)
× nie wstawia HTML z treści posta
× nie przepuszcza linku javascript:
AssertionError: expected <img src="x" onerror="alert(1)"></img> to be null
Tests 2 failed | 22 passed (24)Test formatowania przeszedł, bo na ekranie wszystko wyglądało dobrze. Padły dwa testy bezpieczeństwa: obrazek z onerror trafił na stronę, a link zachował adres javascript:. Dokumentacja marked sama ostrzega, że biblioteka nie czyści wyniku i każe przepuścić go przez osobną paczkę. Dziura była niewidoczna dla oka, a test pokazał ją w sekundę.
Edytor z podglądem na żywo
Pirat chce widzieć efekt, zanim opublikuje post. Drugie polecenie: "W @components/CreatePostForm.tsx obok pola treści pokaż podgląd na żywo przez PostBody. Na telefonie podgląd pod polem". W formularzu pole treści i podgląd stoją teraz w siatce:
<div className="grid gap-2 md:grid-cols-2">
<textarea
value={content}
onChange={(event) => setContent(event.target.value)}
rows={6}
placeholder="Treść w Markdownie: **pogrubienie**, - lista, [link](https://...)"
aria-label="Treść posta"
className="w-full rounded border border-gray-300 p-2 font-mono text-sm"
/>
<section aria-label="Podgląd posta" className="rounded border border-dashed border-gray-300 p-2">
{content.trim() ? (
<PostBody content={content} />
) : (
<p className="text-sm text-gray-400">Tu zobaczysz podgląd posta.</p>
)}
</section>
</div>Jeden stan content zasila pole i podgląd, więc każdy znak od razu zmienia sformatowany post obok. md:grid-cols-2 stawia je obok siebie od średnich ekranów, a na telefonie podgląd ląduje pod polem. Podgląd korzysta z tego samego PostBody co karta, więc pirat widzi dokładnie to, co zobaczy załoga. Nic się nie zapisuje, dopóki nie kliknie Opublikuj.
Przegląd kapitana
- Furtka zamknięta w przeglądarce. Uruchom
npm run devi wpisz w pole treści<img src=x onerror=alert(1)>oraz[mapa](javascript:alert(1)). Podgląd pokazuje znacznik jako napis, a link "mapa" nie ma adresu. Żadne okienko nie może wyskoczyć. - Zero trafień. Wyszukaj w Cursorze w całym projekcie
dangerouslySetInnerHTML. Oczekujesz zera trafień. - Paczki pod lupą. Typowy błąd agenta to
rehype-rawdodane "żeby działał HTML w postach". Ta wtyczka włącza HTML z treści, a dokumentacja react-markdown przewiduje ją dla treści, którym ufasz, i dla pewności radzi dołożyćrehype-sanitize. Na forum, które pisze cała załoga, HTML nie jest potrzebny, więc taką zmianę odrzucasz. - Style działają. Opublikuj przez formularz post Polly z początku lekcji. Nagłówek ma być większy od tekstu, a lista mieć kropki. Gdy wszystko wygląda jak jeden szary akapit, brakuje linii
@pluginalbo Claude dopisał konfigurację Tailwinda 3. Gdy agent przeniesie klasy na<ReactMarkdown className="prose">,npm run buildzatrzyma go błędem:Property 'className' does not exist.
Następny krok
Gdy testy, lint i build są zielone, poproś o commit, na przykład "Markdown w postach: PostBody, podgląd, testy bezpieczeństwa". Potem mały krok w tej samej pętli:
Dodaj przekreślenie (~~tekst~~) i tabele z GitHub Flavored Markdown
przez wtyczkę remark-gfm. Najpierw test w @components/PostBody.test.tsx:
"~~stary kurs~~ nowy kurs" daje element del z tekstem "stary kurs".
Uruchom testy i pokaż wynik, a potem zatrzymaj się przed kodem.Test padnie z komunikatem expected undefined to be 'stary kurs', bo bez wtyczki tyldy zostają zwykłym tekstem. Jeśli wieczór się kończy, zostaw go czerwonego i wyjdź z sesji przez /exit. Czerwony test to najlepsza zakładka w dzienniku: jutro od razu wiesz, gdzie skończyłeś. Testy bezpieczeństwa uruchomią się razem z nim, więc wtyczka nie otworzy furtki po cichu. W edytorze poniżej czeka mały edytor z podglądem, który buduje elementy React zamiast HTML: wstaw próbę ataku i zobacz, że zostaje napisem.
Pamiętaj: na pergaminie załogi każdy pisze własnym atramentem, ale pieczęć przykłada kapitan, a test sprawdza, czy nikt jej nie podmienił.
Kod do tej lekcji: App.jsx
// Pergaminy załogi: Markdown zamieniany na elementy React, nigdy na tekst HTML
import { useState } from 'react';
// Jak domyślne ustawienie react-markdown: tylko bezpieczne rodzaje adresów
const isSafeUrl = (url) => /^(https?:|mailto:|\/)/i.test(url);
// **pogrubienie** i [link](adres) w jednej linii
function renderInline(text, lineKey) {
const parts = text.split(/(\*\*[^*]+\*\*|\[[^\]]+\]\([^)\s]+\))/g);
return parts.map((part, i) => {
const key = lineKey + '-' + i;
const bold = part.match(/^\*\*([^*]+)\*\*$/);
if (bold) return <strong key={key}>{bold[1]}</strong>;
const link = part.match(/^\[([^\]]+)\]\(([^)\s]+)\)$/);
if (link) {
return (
<a key={key} href={isSafeUrl(link[2]) ? link[2] : ''} className="text-blue-600 underline">
{link[1]}
</a>
);
}
// Zwykły tekst: React pokaże go jako napis, także <img ...> i <script>
return part;
});
}
// Nagłówki (#, ##), listy (- ) i akapity
function renderMarkdown(markdown) {
const blocks = [];
let items = [];
const closeList = () => {
if (items.length > 0) {
blocks.push(<ul key={'ul-' + blocks.length} className="ml-5 list-disc space-y-1">{items}</ul>);
items = [];
}
};
markdown.split('\n').forEach((line, i) => {
if (line.startsWith('- ')) {
items.push(<li key={i}>{renderInline(line.slice(2), i)}</li>);
return;
}
closeList();
if (line.startsWith('## ')) blocks.push(<h3 key={i} className="text-lg font-bold">{renderInline(line.slice(3), i)}</h3>);
else if (line.startsWith('# ')) blocks.push(<h2 key={i} className="text-xl font-bold">{renderInline(line.slice(2), i)}</h2>);
else if (line.trim()) blocks.push(<p key={i}>{renderInline(line, i)}</p>);
});
closeList();
return blocks;
}
const startText = `## Zapasy na rejs
**Uwaga:** przy Zatoce Mgieł widziano Krakena.
- beczka wody
- suchary
[Mapa portu](https://example.com/tortuga)`;
const attack = '\n\n<img src=x onerror=alert(1)> [kliknij](javascript:alert(1))';
export default function App() {
const [content, setContent] = useState(startText);
return (
<div className="min-h-screen bg-gray-100 p-4 text-gray-900">
<div className="mx-auto max-w-3xl space-y-3">
<h1 className="text-2xl font-bold">Nowy post w Crew Council</h1>
<div className="grid gap-3 md:grid-cols-2">
<textarea
value={content}
onChange={(event) => setContent(event.target.value)}
rows={12}
aria-label="Treść posta"
className="w-full rounded border border-gray-300 bg-white p-2 font-mono text-sm"
/>
<section aria-label="Podgląd posta" className="space-y-2 rounded border border-dashed border-gray-400 bg-white p-3">
{content.trim() ? renderMarkdown(content) : <p className="text-gray-400">Tu zobaczysz podgląd posta.</p>}
</section>
</div>
<button
type="button"
onClick={() => setContent((prev) => prev + attack)}
className="rounded bg-red-700 px-3 py-1 text-white hover:bg-red-800"
>
Wstaw próbę ataku
</button>
<p className="text-sm text-gray-600">
Znacznik img zostaje napisem, a link javascript: traci adres. Podgląd nie używa dangerouslySetInnerHTML.
</p>
</div>
</div>
);
}Widzisz błąd w tej lekcji?
Sprawdź się
Odpowiedz na pytania z tej lekcji. Wybierz odpowiedź, a od razu zobaczysz, czy jest poprawna.
1. Czym jest Markdown w kontekście postów na forum?
2. Dlaczego Crew Council renderuje treść postów przez react-markdown, a nie przez marked i dangerouslySetInnerHTML?
Zadania praktyczne w grze
- Edytor kodu
Markdown editor z live preview
- Układanie w poziomie
Ułóż zapis pogrubionego tekstu w Markdown (jedna linia, od lewej do prawej):