Guide : tous les blocs disponibles pour vos articles

Un article de ce blog est un simple fichier Markdown : src/content/blog/fr/mon-slug.md pour le français, src/content/blog/en/mon-slug.md pour l’anglais — même nom de fichier, même article. Cet article de référence montre le rendu de chaque bloc disponible.

Les titres de section

Un titre de niveau 2 (##) structure l’article, exactement comme celui juste au-dessus. C’est le seul niveau de titre utilisé dans le corps d’un article.

Les paragraphes

Un paragraphe est un simple bloc de texte. Il peut contenir du gras, de l’italique et du code en ligne pour citer un nom de fichier ou une commande.

Les listes

Les listes à puces prennent le style « losange jaune » de la charte :

• Premier point, court et concret.
• Deuxième point, avec du code en ligne si besoin.
• Troisième point, parce que deux c’est trop peu.

Les citations

Une citation est mise en avant dans un bloc sombre avec les grands guillemets jaunes :

Un bon outil pédagogique se remarque quand on l’oublie — il ne doit jamais se mettre entre l’apprenant et le savoir.

Les blocs de code

Un bloc de code s’écrit entre triples accents graves, avec le langage en option :

const posts = await getCollection('blog');
const french = posts.filter((p) => p.id.startsWith('fr/'));
console.log(`${french.length} articles en français`);

Les images

Une image se pose dans src/assets/blog/ (partagé entre les deux langues) et se référence en chemin relatif. Au build, sharp la convertit en WebP et génère plusieurs largeurs (srcset) — le navigateur télécharge la taille adaptée :

Le frontmatter

Chaque fichier commence par un en-tête YAML : title, excerpt, date, author, category, tags, readTime, illu, accent et l’option featured pour la une. La catégorie et l’illustration se choisissent parmi les valeurs du studio — le build échoue si une valeur est inconnue, impossible de se tromper silencieusement.