HTML — Conventions d’écriture

Des balises en minuscules, des valeurs entre guillemets, des noms de classes explicites et une indentation régulière : quelques habitudes suffisent pour rendre le HTML plus facile à relire et à modifier.

Des conventions d’écriture communes facilitent la relecture, la recherche d’erreurs et les modifications. La régularité ne garantit pas à elle seule un HTML valide, mais elle permet de repérer plus vite une structure inhabituelle. Choisissez des règles simples, que toute l’équipe pourra appliquer sans effort excessif.

Adopter quelques règles simples et communes

Écrivez les noms de balises et d’attributs en minuscules, placez les valeurs entre guillemets et indentez les éléments enfants de façon régulière. Mettez les grandes parties de la structure sur des lignes distinctes. Pour les attributs, adoptez un ordre stable, par exemple l’identifiant et la classe, puis les informations propres à l’élément, enfin les attributs d’accessibilité et de comportement. C’est une convention de lecture, pas une obligation du langage.

<article class="course-card" data-level="beginner">
  <header>
    <p class="eyebrow">Cours gratuit</p>
    <h2>Les bases de HTML</h2>
  </header>
  <p>Créez des documents structurés et accessibles.</p>
  <a href="/courses/html">Commencer le cours</a>
</article>

• Écrivez les noms en minuscules.
• Placez les valeurs d’attributs entre guillemets.