Cours Vibe coding avec Claude Code · Module 5: Clone de Reddit
Les parchemins de l'équipage : du Markdown dans les posts, sans script de contrebande
Dans cette leçon9
Polly veut lister dans un post les provisions du voyage, et Redbeard veut mettre en gras l'avertissement sur le Kraken. Mais le champ de contenu n'accepte que du texte brut, et leurs posts ressemblent à un seul long paragraphe. La porte dérobée la plus simple serait de laisser entrer du HTML dans les posts, mais alors n'importe quel pirate pourrait coller un script qui s'exécuterait dans le navigateur de tout l'équipage. Dans cette leçon, Claude Code ajoute la mise en forme en gardant la porte fermée, et un test vérifie qu'elle l'est vraiment.
Problème : de la mise en forme sans porte dérobée
Markdown est une écriture simple de la mise en forme avec des caractères ordinaires. Des dièses en début de ligne font un titre, un tiret un point de liste, deux étoiles de chaque côté du gras, et des crochets suivis de parenthèses un lien. Voici le post de Polly :
## Provisions pour le voyage
**Attention :** le Kraken a été aperçu près de la baie des Brumes.
- un tonneau d'eau
- des biscuits de mer
[Carte du port](https://example.com/tortuga)Le gras tient en trois parties sur une ligne : **, le texte, puis de nouveau **. Tu écris ce texte comme n'importe quel autre, et tu ne le transformes en titres et en listes qu'à l'affichage. C'est là que le piège t'attend. Beaucoup de bibliothèques transforment le Markdown en HTML déjà prêt, qu'il faut insérer avec dangerouslySetInnerHTML. Tu connais la règle depuis la leçon 3_3 : le contenu venu des utilisateurs, tu ne l'affiches jamais avec dangerouslySetInnerHTML. Il te faut donc un outil qui construit à partir du Markdown des éléments React, et non du texte HTML.
Demande pour Claude Code
La bibliothèque, tu la désignes toi-même dans la demande, car c'est une décision de sécurité et non de confort. D'après sa documentation, react-markdown est sûre par défaut : elle construit un arbre d'éléments React, n'utilise pas dangerouslySetInnerHTML et n'exécute pas le HTML du contenu.
Demande pour Claude Code :
Ajoute du Markdown au contenu des posts de Crew Council : titres, gras,
listes et liens. Le contenu est écrit par les utilisateurs, donc rends-le
avec la bibliothèque react-markdown, sans dangerouslySetInnerHTML et sans
HTML brut. Un seul composant components/PostBody.tsx pour la carte du
post et la page du post. Styles : classe prose de @tailwindcss/typography
(Tailwind 4, @plugin dans @app/globals.css). D'abord les tests dans
components/PostBody.test.tsx : le Markdown donne un titre, du gras et une
liste ; le texte <img src="x" onerror="alert(1)"> ne crée pas d'image ;
un lien javascript: perd son adresse. N'ajoute aucun autre paquet.
À la fin, tests, lint et build, montre le résultat.La phrase sur les autres paquets n'est pas une décoration. Chaque paquet est le code d'un inconnu dans ton projet, et Claude aime en ajouter "au passage" pour la coloration du code ou la prise en charge du HTML.
Ce que Claude a fait : deux paquets
Ouvre dans Cursor le panneau Source Control et clique sur package.json. Dans dependencies, une ligne est apparue :
"dependencies": {
"next": "16.4.6",
"react": "19.3.0",
"react-dom": "19.3.0",
"react-markdown": "^10.1.0"
},dependencies contient les paquets dont l'application a besoin pour fonctionner. Le second paquet, "@tailwindcss/typography": "^0.5.20", est allé dans devDependencies, parce qu'il ne sert qu'à construire les styles (versions : état de novembre 2026). Le chapeau ^ permet à npm d'installer des versions plus récentes sans changement cassant. Il n'y a ici ni marked, ni rehype-raw, ni dompurify : exactement les deux paquets que tu as demandés. Dans app/globals.css, une ligne s'est ajoutée sous l'import de Tailwind :
@import "tailwindcss";
@plugin "@tailwindcss/typography";@plugin est la manière de Tailwind 4 de déclarer des plugins. Le fichier tailwind.config.js avec require(...) est la voie de Tailwind 3, que la documentation du plugin ne décrit plus que pour les anciens projets.
Ce que Claude a écrit : PostBody
Ouvre 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 reçoit le texte du post comme enfant et renvoie de simples éléments React : h2, strong, ul, a. Les classes se trouvent sur le div qui l'entoure, parce que la version actuelle de la bibliothèque n'accepte pas la prop className. prose donne leur taille aux titres et des puces aux listes, prose-sm réduit le texte à la taille d'une carte, max-w-none retire la limite de largeur que prose fixe pour le confort de lecture, et prose-a:text-blue-600 ne colore que les liens. Le composant n'a pas de "use client", il fonctionne donc aussi bien sur la page du post que dans la carte à l'intérieur de Feed. La carte et la page du post affichent maintenant le contenu par <PostBody content={post.content} />.
Ce que Claude a écrit : le test qui garde la porte
Ouvre components/PostBody.test.tsx. render de Testing Library, que Claude a installée dans la leçon 4_1, dessine le composant dans un faux navigateur, et container est l'élément où atterrit le résultat. Deux cas gardent la sécurité :
it("n'insère pas le HTML venu du contenu du post", () => {
const { container } = render(<PostBody content={'<img src="x" onerror="alert(1)">'} />);
expect(container.querySelector("img")).toBeNull();
});
it("ne laisse pas passer un lien javascript:", () => {
const { container } = render(<PostBody content="[carte](javascript:alert(1))" />);
expect(container.querySelector("a")?.getAttribute("href")).toBe("");
});querySelector renvoie le premier élément qui correspond au sélecteur CSS, ou null, et toBeNull attend qu'un tel élément n'existe pas. onerror est du code que le navigateur exécute quand une image ne se charge pas, donc une telle balise suffit pour une attaque. react-markdown l'affiche comme un simple texte. Un lien javascript: exécute du code au clic, c'est pourquoi la bibliothèque ne laisse passer que les genres d'adresses sûrs, comme https et mailto, et remplace le reste par une adresse vide. Le premier test du fichier vérifie la mise en forme elle-même : un titre, du gras et deux points de liste.
L'épreuve de l'épreuve
Un test qui passe toujours ne garde rien. Nous avons donc essayé la version que les agents aiment écrire : la bibliothèque marked transforme le Markdown en texte HTML, et le composant l'insère par dangerouslySetInnerHTML. Voici le milieu du résultat :
❯ components/PostBody.test.tsx (3 tests | 2 failed)
× n'insère pas le HTML venu du contenu du post
× ne laisse pas passer un lien javascript:
AssertionError: expected <img src="x" onerror="alert(1)"></img> to be null
Tests 2 failed | 22 passed (24)Le test de mise en forme est passé, parce qu'à l'écran tout avait l'air bien. Les deux tests de sécurité sont tombés : l'image avec onerror a atterri sur la page, et le lien a gardé son adresse javascript:. La documentation de marked avertit elle-même que la bibliothèque ne nettoie pas le résultat et demande de le faire passer par un paquet à part. La brèche était invisible à l'œil, et le test l'a montrée en une seconde.
Un éditeur avec aperçu en direct
Le pirate veut voir l'effet avant de publier son post. Seconde demande : "Dans @components/CreatePostForm.tsx, à côté du champ de contenu, montre un aperçu en direct avec PostBody. Sur téléphone, l'aperçu sous le champ". Dans le formulaire, le champ de contenu et l'aperçu se tiennent maintenant dans une grille :
<div className="grid gap-2 md:grid-cols-2">
<textarea
value={content}
onChange={(event) => setContent(event.target.value)}
rows={6}
placeholder="Contenu en Markdown : **gras**, - liste, [lien](https://...)"
aria-label="Contenu du post"
className="w-full rounded border border-gray-300 p-2 font-mono text-sm"
/>
<section aria-label="Aperçu du post" className="rounded border border-dashed border-gray-300 p-2">
{content.trim() ? (
<PostBody content={content} />
) : (
<p className="text-sm text-gray-400">Tu verras ici l'aperçu du post.</p>
)}
</section>
</div>Un seul état content alimente le champ et l'aperçu, donc chaque caractère change aussitôt le post mis en forme à côté. md:grid-cols-2 les place côte à côte à partir des écrans moyens, et sur téléphone l'aperçu tombe sous le champ. L'aperçu utilise le même PostBody que la carte, le pirate voit donc exactement ce que verra l'équipage. Rien n'est enregistré tant qu'il ne clique pas sur Publier.
La revue du capitaine
- La porte est fermée dans le navigateur. Lance
npm run devet tape dans le champ de contenu<img src=x onerror=alert(1)>puis[carte](javascript:alert(1)). L'aperçu montre la balise comme du texte, et le lien "carte" n'a pas d'adresse. Aucune fenêtre ne doit surgir. - Zéro résultat. Cherche dans Cursor, dans tout le projet,
dangerouslySetInnerHTML. Tu attends zéro résultat. - Les paquets sous la loupe. L'erreur typique d'un agent est
rehype-raw, ajouté "pour que le HTML marche dans les posts". Ce plugin active le HTML du contenu, et la documentation de react-markdown le prévoit pour un contenu auquel tu fais confiance, en conseillant par prudence d'ajouterrehype-sanitize. Sur un forum que tout l'équipage écrit, le HTML n'est pas nécessaire, tu refuses donc ce changement. - Les styles fonctionnent. Publie par le formulaire le post de Polly du début de la leçon. Le titre doit être plus grand que le texte, et la liste avoir des puces. Si tout ressemble à un seul paragraphe gris, la ligne
@pluginmanque ou Claude a écrit une configuration de Tailwind 3. Si l'agent déplace les classes vers<ReactMarkdown className="prose">,npm run buildl'arrête avec une erreur :Property 'className' does not exist.
Étape suivante
Quand les tests, le lint et le build sont verts, demande un commit, par exemple "Markdown dans les posts : PostBody, aperçu, tests de sécurité". Puis une petite étape dans la même boucle :
Ajoute le texte barré (~~texte~~) et les tableaux de GitHub Flavored
Markdown avec le plugin remark-gfm. D'abord un test dans
@components/PostBody.test.tsx : "~~ancien cours~~ nouveau cours" donne
un élément del avec le texte "ancien cours". Lance les tests et montre
le résultat, puis arrête-toi avant le code.Le test tombera avec le message expected undefined to be 'ancien cours', car sans le plugin les tildes restent du texte ordinaire. Si la soirée s'achève, laisse-le rouge et quitte la session par /exit. Un test rouge est le meilleur signet du livre de bord : demain tu sais tout de suite où tu t'es arrêté. Les tests de sécurité se lanceront avec lui, donc le plugin n'ouvrira pas la porte en silence. Dans l'éditeur ci-dessous t'attend un petit éditeur avec aperçu qui construit des éléments React au lieu de HTML : colle-y une tentative d'attaque et vois qu'elle reste du texte.
À retenir : sur le parchemin de l'équipage, chacun écrit de sa propre encre, mais le sceau, c'est le capitaine qui l'appose, et le test vérifie que personne ne l'a remplacé.
Code de cette leçon : App.jsx
// Les parchemins de l'équipage : le Markdown devient des éléments React, jamais du texte HTML
import { useState } from 'react';
// Comme le réglage par défaut de react-markdown : seulement des genres d'adresses sûrs
const isSafeUrl = (url) => /^(https?:|mailto:|\/)/i.test(url);
// **gras** et [lien](adresse) sur une seule ligne
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>
);
}
// Texte ordinaire : React l'affiche comme du texte, y compris <img ...> et <script>
return part;
});
}
// Titres (#, ##), listes (- ) et paragraphes
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 = `## Provisions pour le voyage
**Attention :** le Kraken a été aperçu près de la baie des Brumes.
- un tonneau d'eau
- des biscuits de mer
[Carte du port](https://example.com/tortuga)`;
const attack = '\n\n<img src=x onerror=alert(1)> [clique](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">Nouveau post dans 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="Contenu du post"
className="w-full rounded border border-gray-300 bg-white p-2 font-mono text-sm"
/>
<section aria-label="Aperçu du post" 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 verras ici l'aperçu du post.</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"
>
Insérer une tentative d'attaque
</button>
<p className="text-sm text-gray-600">
La balise img reste du texte, et le lien javascript: perd son adresse. L'aperçu n'utilise pas dangerouslySetInnerHTML.
</p>
</div>
</div>
);
}Tu as repéré une erreur dans cette leçon ?
Teste tes connaissances
Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.
1. Qu'est-ce que Markdown dans le contexte des posts d'un forum ?
2. Pourquoi Crew Council affiche-t-il le contenu des posts avec react-markdown et non avec marked et dangerouslySetInnerHTML ?
Tâches pratiques dans le jeu
- Éditeur de code
Éditeur Markdown avec aperçu en direct
- Tri horizontal
Ordonne la notation du texte en gras en Markdown (sur une seule ligne, de gauche à droite) :