Blog SEO · Technique
Commentaire HTML et SEO : syntaxe, bons usages et vrai impact sur Google
Un commentaire HTML documente le code sans rien afficher à l’internaute. Peut-on y glisser des mots-clés ? Ralentit-il le site ? Faut-il supprimer ceux de WordPress ? Réponse courte : ils n’aident pas le classement et gênent rarement. Voici le détail.
Commentaire HTMLinvisible pour l’internaute
Effet sur le classementnul, selon les tests SEO
Définition
Qu’est-ce qu’un commentaire HTML ?
Un commentaire HTML est un texte placé dans le code source d’une page, entre la balise d’ouverture <!-- et la balise de fermeture -->. Le navigateur ne l’affiche pas : seul quelqu’un qui consulte le code source (clic droit, « Afficher le code source ») peut le lire.
On s’en sert pour expliquer une portion de code, marquer le début et la fin d’une section, laisser une consigne à un autre développeur ou désactiver temporairement un élément sans le supprimer.
Exemple : <!-- Début du formulaire de contact -->. Tout ce qui se trouve entre les deux balises est ignoré à l’affichage, y compris du HTML complet.
- Syntaxe : <!– votre texte –>
- Invisible à l’écran, lisible dans le code source
- Peut s’étendre sur plusieurs lignes
Syntaxe
La syntaxe en pratique
La règle tient en une ligne, mais quelques détails évitent les erreurs d’affichage. Le tableau ci-dessous résume les cas les plus fréquents, en HTML comme dans les langages qu’on croise sur la même page.
| Cas | Comment faire | À savoir |
|---|---|---|
| Commentaire sur une ligne | <!-- texte --> | Le cas le plus courant |
| Commentaire sur plusieurs lignes | <!--, le texte sur plusieurs lignes, puis --> | Aucune balise supplémentaire |
| Désactiver un bloc HTML | Entourer le bloc de <!-- et --> | Le code reste dans la page, invisible |
| Commentaires imbriqués | Impossible | Le premier --> ferme tout le commentaire |
| Raccourci dans VS Code | Ctrl + / (Cmd + / sur Mac) | Commente ou décommente la sélection |
| Dans le CSS ou le JavaScript | /* texte */ ou // texte | La syntaxe HTML n’y fonctionne pas |
Impact SEO
Les commentaires HTML ont-ils un impact sur le SEO ?
Non, pas sur le classement. Les tests et retours d’expérience de la communauté SEO concordent : le contenu des commentaires n’est pas pris en compte pour positionner une page. Un mot-clé placé dans un commentaire n’aide donc pas à se positionner, et des dizaines de mots-clés n’aident pas davantage.
L’effet indirect possible concerne le poids de la page. Des milliers de lignes de commentaires alourdissent le HTML, et donc légèrement le temps de chargement. En pratique, c’est presque toujours marginal : la compression des serveurs réduit fortement ce poids, et les images ou les scripts pèsent bien plus lourd.
Pour situer l’ordre de grandeur, Google a indiqué en 2022 que Googlebot prend en compte les 15 premiers mégaoctets du fichier HTML d’une page. Les commentaires d’un site normal en représentent une infime fraction.
| Idée reçue | Ce qu’il en est |
|---|---|
| Des mots-clés en commentaire aident le SEO | Non, ils n’ont pas d’effet sur le classement |
| Les commentaires ralentissent le site | Seulement en très grande quantité ; le gain à les retirer est faible |
| Cacher du texte en commentaire est sans risque | Inutile, et toute tentative de manipulation est à proscrire |
| Il faut supprimer tous les commentaires | Non, ils restent utiles pour la maintenance |
Sources : Google Search Central, « Googlebot and the 15 MB thing » (juin 2022) et WebRankInfo, commentaires HTML et SEO.
Bonnes pratiques
Six bons usages des commentaires HTML
Documenter les sections
Indiquer le début et la fin d’un bloc complexe pour faciliter la maintenance.
Désactiver temporairement
Mettre en pause un élément pendant un test, puis le réactiver.
Rester concis
Des commentaires courts et utiles plutôt que des pavés de texte.
Ne rien divulguer
Aucun mot de passe, chemin serveur ou information sensible : le code source est public.
Nettoyer en production
Les outils de minification peuvent retirer les commentaires du code mis en ligne.
Dater les consignes
Une note « à retirer après le 30 juin » évite les commentaires oubliés pendant des années.
Pièges
Les erreurs à éviter
Laisser des informations sensibles
Identifiants de test, adresses internes ou remarques sur un client : n’importe qui peut lire le code source.
Oublier une balise de fermeture
Sans –>, tout le reste de la page devient un commentaire et disparaît de l’affichage.
Commenter au lieu de supprimer
Un ancien bloc commenté depuis des années encombre le code sans rien apporter. Supprimez-le, l’historique de versions le garde.
Vérifier
Comment repérer les commentaires de votre site
Pour voir les commentaires d’une page, ouvrez-la dans votre navigateur, faites un clic droit puis « Afficher le code source », et cherchez <!-- avec Ctrl + F (Cmd + F sur Mac). Sur un site entier, un outil de crawl comme Screaming Frog permet de rechercher un texte précis dans le code de toutes les pages.
Profitez-en pour vérifier trois points : qu’aucun commentaire ne contient d’information sensible, qu’aucun bloc important n’a été désactivé par erreur, et que les vieux commentaires de test ont bien disparu. C’est un contrôle de dix minutes, utile lors de chaque mise en ligne importante, et qui évite de mauvaises surprises le jour où un concurrent curieux ouvre votre code source.
- Clic droit, « Afficher le code source », puis Ctrl + F
- Un crawler pour contrôler toutes les pages d’un coup
- Un contrôle rapide à chaque mise en ligne
WordPress
Le cas particulier de WordPress et de l’éditeur de blocs
Si vous ouvrez le code d’une page dans l’éditeur WordPress, vous verrez de nombreux commentaires du type <!-- wp:paragraph -->. Ce sont les délimiteurs des blocs : WordPress s’en sert pour reconstruire la mise en page dans l’éditeur.
Ces commentaires sont retirés du HTML affiché aux visiteurs et n’ont aucun effet sur le SEO. Il ne faut surtout pas les supprimer à la main dans l’éditeur de code : vous risqueriez de casser la mise en page, car WordPress ne saurait plus où commence et où finit chaque bloc.
Pour un audit complet de votre site WordPress, voyez notre page SEO WordPress.
À retenir : les commentaires de blocs sont nécessaires à l’éditeur. Si une page semble « cassée » après une modification du code, c’est souvent qu’un délimiteur de bloc a été touché.
Priorités
Ce qui compte vraiment dans votre code pour le SEO
Plutôt que de traquer les commentaires, concentrez-vous sur les éléments du code qui influencent réellement l’indexation et le classement. Ce sont eux que nous vérifions en premier lors d’un audit technique.
La balise title
Unique, descriptive, avec la requête principale et moins de 60 caractères environ.
La structure des titres
Un H1 clair, puis des H2 et H3 qui suivent la logique du contenu.
Les balises robots et canonical
Une erreur de noindex ou de canonical peut faire disparaître une page.
Les données structurées
Elles aident Google à comprendre la page et enrichissent l’affichage.
Le poids réel de la page
Images, scripts et polices pèsent bien plus que les commentaires.
Les liens internes
Ils guident Google vers vos pages importantes.
Témoignages
Ils ont travaillé avec moi
“
Abdoul a fait preuve d’un très grand professionnalisme dans la gestion de mon dossier et de son suivi. De grandes compétences dans un domaine très technique.
i.Tax-answering
“
Son travail est plus que sérieux. Il est vraiment à l’écoute et très pédagogue. Je vous le recommande vivement.
Cabinet Sophie Durand
“
En SEO, il ne s’agit pas juste de trouver le bon mot-clé : c’est un monde à 360°, et Abdoul est d’une pédagogie exemplaire.
Responsable de projet SEO, Solocal
FAQ
Questions fréquentes : commentaires HTML
Placez votre texte entre <!– et –>. Tout ce qui se trouve entre ces deux balises est ignoré par le navigateur à l’affichage.
Il les voit dans le code, mais les tests SEO montrent que leur contenu n’influence pas le classement des pages.
Cela n’apporte aucun bénéfice SEO, et cacher du texte pour manipuler les résultats est à proscrire.
Très peu. Seule une quantité très importante de commentaires a un effet mesurable sur le poids de la page, et la compression du serveur le réduit encore.
Non. Le premier –> rencontré ferme le commentaire, et le reste s’affiche. Il faut fermer chaque commentaire avant d’en ouvrir un autre.
Dans la plupart des éditeurs, dont VS Code, Ctrl + / (ou Cmd + / sur Mac) commente ou décommente la sélection.
Non : les commentaires de blocs sont nécessaires à l’éditeur et ne sont pas affichés aux visiteurs.
À lire aussi
Pour aller plus loin
SEO WordPress
Un site WordPress rapide, propre et bien positionné.
Lire la page →SEO pour site Wix
Bien référencer un site créé avec Wix.
Lire la page →Tarif d’un audit SEO
Prix, contenu et livrables d’un audit SEO.
Lire la page →Consultant SEO freelance
Un expert indépendant, sans intermédiaire.
Lire la page →Le blog SEO
Guides, tarifs et conseils pratiques.
Lire la page →Un doute sur la technique de votre site ?
Envoyez-nous l’adresse de votre site : nous revenons vers vous avec un pré-audit gratuit et les trois actions prioritaires pour progresser sur Google.