lorsque vous utilisez un titre markdown de premier niveau (#) dans un sujet, cela se traduira-t-il par h1 ou h2 dans la sortie HTML ?
Il affichera un <h1> ![]()
Donc, cela signifie que Discourse suppose qu’il est bon d’avoir plusieurs balises <h1> sur une page ? Il me semble que si le titre du sujet est h1, les titres de premier niveau à l’intérieur de ce sujet devraient être h2 par défaut, non ?
Discourse ne suppose rien, il affichera ce que vous lui demandez d’afficher.
Il est préférable d’utiliser ## comme titres de niveau supérieur à l’intérieur d’une publication, c’est certain ![]()
C’est certainement une « éducation des utilisateurs » que nous pourrions nous épargner en ne faisant pas de # un titre de niveau 1… ![]()
Savez-vous s’il existe un moyen de changer cela ? Ou au moins de masquer les titres de niveau 1 dans la barre d’outils ? (Je suppose que les personnes qui écrivent directement en Markdown sont une cible d’éducation réaliste…)
Oui, c’est assez simple. L’élément de liste a un attribut data-name="heading-1" que vous pouvez cibler avec du CSS ![]()
Hé hé - J’étais justement en train de regarder ça aussi. Dans un test rapide, ceci masque l’option H1 dans le compositeur en markdown et en texte enrichi :
button[data-name="heading-1"] {
display: none;
}
(Je vais peut-être garder ça ! Je ne vois pas vraiment de raison d’offrir le H1 dans le compositeur.)
Je vois votre point, mais ce n’est pas quelque chose que Discourse a nécessairement décidé d’une manière ou d’une autre. Discourse suit une convention markdown appelée CommonMark, et elle spécifie que # doit être converti en H1. Je pense que cette convention pour la manière dont les titres markdown sont convertis en balises HTML est assez standard dans les spécifications markdown majeures.
Eh bien, deux titres <h1> ne sont pas une si grande question en fait. C’est un très vieux mème de SEO, qui n’est plus un problème depuis longtemps. Google et autres utiliseront le premier ou celui qu’ils jugent le plus approprié.
Nous pouvons discuter si deux en-têtes principaux sont la décision la plus judicieuse en termes de contenu, mais lorsqu’une plateforme utilisera un style différent pour le nom du sujet et les en-têtes dans les publications, cela n’a pas vraiment d’importance.
Il est néanmoins plus approprié d’utiliser ##/<h2> dans les publications. Mais comme cela ne joue aucun rôle réel, mon avis est qu’il vaut mieux que les utilisateurs utilisent des en-têtes qui évitent ceux-là parce qu’ils ont peur d’utiliser les mauvais en-têtes ![]()
Les titres ne sont peut-être qu’un petit signal pour le SEO aujourd’hui, mais je n’aime toujours pas les multiples H1 parce que je suis un nerd. ![]()
Je pense aussi à la façon dont Steph crée une documentation imprimable pour la publication de pages, où les H1 dans l’article s’affichent encore plus grands que le H1 supérieur de la page :
Les transformer en H2 les maintiendrait légèrement plus petits que le H1 supérieur :
Oui, c’est ça le problème. Pour moi, il est naturel d’utiliser d’abord l’en-tête de premier niveau, mais si le thème n’est pas stylisé avec la même supposition, c’est désordonné. Il y a une sorte de déconnexion ici.
(Note secondaire : est-ce que cela vous montre le document en anglais sans aucune intervention de votre part ?!?)
C’est naturel, oui, et cela a du sens lorsque vous construisez une page web à partir de zéro. Mais un système de gestion de contenu (CMS) ou un système de publication obtient presque toujours le H1 de la page à partir d’un champ de titre, vous utiliseriez donc généralement le H2 pour les sections de contenu.
(Et j’ai utilisé l’outil de traduction du navigateur web pour obtenir l’anglais.)
Je suis d’accord. Mais nous ne devrions pas nous attendre à ce que les membres de la communauté le sachent, à mon humble avis.
Oui – et je ne vois aucun inconvénient à simplement masquer l’option H1.
Bien que je ne voie pas beaucoup d’utilisation des titres par la plupart des utilisateurs lors de la création de messages typiques. Les personnes créant des sujets de documentation plus longs auront probablement (ou auront rapidement) un peu plus d’expérience avec ## et cette icône “TT”.
(Aussi : je viens de remarquer cette vieille discussion intéressante où il est suggéré que les titres ne devraient être utilisés que dans les sujets, et interdits dans les réponses : Désactiver les en-têtes dans les réponses comme h1 et h2)

