Les en-têtes sont l'épine dorsale de tout document Markdown. Ils définissent la structure, permettent la navigation, affectent l'accessibilité et influencent SEO. Ce guide couvre tout ce qui concerne Markdown titres syntaxe, règles de hiérarchie, différences entre les plateformes et meilleures pratiques.
Syntaxe de l'en-tête
Markdown les rubriques utilisent le # le symbole (de type ATX). Le nombre de # caractères détermine le niveau de l'en-tête:
# Heading 1
## Heading 2
### Heading 3
#### Heading 4
##### Heading 5
###### Heading 6Il existe également le style Setext (seulement H1 et H2):
Heading 1
=========
Heading 2
---------Type ATX (#) est préférable il est plus explicite et fonctionne pour les six niveaux.
Ce que signifie chaque niveau de rubrique
| Le niveau | HTML Étiquette | Objectif de l'action |
|---|---|---|
| H1 | <h1> | Titre de page ou de document |
| H2 | <h2> | Section principale |
| H3 | <h3> | Sous-section dans H2 |
| H4 | <h4> | Sous-sous-section dans H3 |
| H5 | <h5> | Rarement utilisé dans la pratique |
| H6 | <h6> | On n' en a presque jamais besoin . |
La plupart des documents utilisent uniquement H1H3. H4H6 indique généralement que la structure du document est trop profonde.
H1: Une page par page
Un titre H1 doit apparaître exactement une fois par document Markdown. Il représente le titre du document ou le sujet principal de la page.
Ça va.
# How to Convert Word to MarkdownÉvitez:
# Section One
...
# Section Two ← Don't use multiple H1sLes moteurs de recherche et les outils d'accessibilité s'attendent à un seul H1 par page. Plusieurs H1 confondent les deux.
Règles de hiérarchie des rubriques
On avance toujours dans l'ordre. Ne sautez pas les niveaux:
C' est vrai .
# Document Title
## Section
### Subsection
#### DetailC' est faux:
# Document Title
#### Jumped to H4 ← Skips H2 and H3Le fait de sauter les niveaux d'en-tête enfreint le schéma du document et ne respecte pas les lignes directrices de l'accessibilité du WCAG.
Conversion des rubriques Word en Markdown
Lorsque vous convertissez un document Word avec WordToMD, Words les styles d'en-tête intégrés cartographient directement:
| Word Le style | Markdown Produit |
|---|---|
| Titre 1 | # Heading |
| Titre 2 | ## Heading |
| Titre 3 | ### Heading |
| Normalité + audacieux | **Bold text** (Aucune rubrique) |
Le problème le plus fréquent: les rédacteurs en gras manuellement et augmenter la taille de la police au lieu d'appliquer le style de l'en-tête. Cela crée un texte qui ressemble à un titre dans Word mais convertit en texte en gras dans Markdown. Voir aussi: Word à Markdown Guide de mise en forme pour comment réparer ça.
Identifiants de titre et liens d'ancrage
La plupart des processeurs Markdown génèrent automatiquement des identifiants à partir du texte de l'en-tête:
## Getting StartedGénérateurs: <h2 id="getting-started">Getting Started</h2>
Vous pouvez le relier à:
See the [Getting Started section](#getting-started).Règles pour les identifiants générés automatiquement:
- Tous les caractères en minuscules
- Remplacer les espaces par des trait d'union
- Caractères spéciaux à l'exception des trait d'union
Des exemples:
## API Reference→#api-reference## What's New?→#whats-new## Step 1: Install→#step-1-install
Tableau des matières
Pour les documents longs, générer un TOC à l'aide de liens d'ancrage d'en-tête:
## Table of Contents
- [Installation](#installation)
- [Configuration](#configuration)
- [Basic Settings](#basic-settings)
- [Advanced Options](#advanced-options)
- [Usage](#usage)
- [FAQ](#faq)GitHub génère automatiquement un TOC dans le coin supérieur gauche de tout fichier Markdown avec des en-têtes.
SEO Considérations
Pour Markdown utilisé dans des sites statiques (Jekyll, Hugo, Astro) et publié sur le web:
- H1 = titre de la page Inscrivez votre mot-clé principal. Une par page.
- H2s = sections principales Inclure naturellement les mots clés secondaires
- H3s = sous-sections Thèmes plus spécifiques
- Gardez les en-têtes descriptifs Comment installer les dépendances battements Installation
- Les titres sont indexés par les moteurs de recherche ils sont scannés
Voir aussi: Word au générateur de site statique pour la publication de documents Markdown sur le web.
Accès
Les lecteurs d'écran utilisent la hiérarchie des en-têtes pour aider les utilisateurs à naviguer. Les lignes directrices:
- Ne sautez pas les niveaux d'orientation (H1 → H3 sans H2)
- N'utilisez pas les en-têtes uniquement pour la mise en forme visuelle (utilisez en gras ou CSS à la place)
- Rendre le texte de l'en-tête significatif éviter la section 1, la partie A
- Gardez les titres concis mais descriptifs
Titre rendu par plateforme
| La plateforme | H1 à H6 | Identifiants automatiques | Autonomie de la prise en charge |
|---|---|---|---|
| GitHub | ✅ | ✅ | ✅ (par l'intermédiaire du bouton) |
| Obsidian | ✅ | ✅ | Par le plugin |
| GitBook | ✅ | ✅ | ✅ (barre latérale) |
| Notion | Seulement H1-H3 | ❌ | ❌ |
| Vue d' avant du code VS | ✅ | ✅ | ❌ |
| Je vous en prie. | ✅ | ✅ | ✅ |
Notion ne prend en charge que trois niveaux d'en-tête (appelés en-tête 1, 2 et 3 dans leur éditeur, correspondant à H1H3).
Des erreurs courantes
Oublier l'espace après #
#Not a heading ← Missing space
# This is correctL'espace entre # et le texte de l'en-tête est requis dans CommonMark.
Utilisation de rubriques pour le style, pas pour la structure
Utilisation ### rendre le texte légèrement plus petit sans qu'il soit une sous-section réelle rompt la structure du document. Utilisez plutôt du texte stylisé ou des classes CSS.
Le surnageageage Si vous avez besoin de H5 et H6, considérez si le contenu doit être divisé en pages distinctes.
FAQ
Quelle est la différence entre les styles d'en-tête ATX et Setext?
Utilisations de l'ATX # Des personnages. Les utilisations de Setext sont soulignées (=== pour le H1, --- pour H2). ATX est préféré car il est sans ambiguïté et fonctionne pour H1H6.
Je peux avoir plusieurs H2 ? Oui, c'est tout. H2 définit les sections principales, et un document en a généralement plusieurs.
Le saut de niveau de la route affectera-t-il SEO? Il affecte l'accessibilité plus que SEO directement, mais une structure sémantique propre est un signal positif. Les moteurs de recherche préfèrent un contenu bien structuré.
Mon document converti a tous les titres au même niveau. Qu'est-ce qui ne va pas ? Le document Word utilise le formatage manuel au lieu des styles d'en-tête. Voir aussi: Word à Markdown Guide de mise en forme Pour le remède.
Conclusion de l'enquête
Markdown Les en-têtes sont simples en syntaxe mais importants en impact. Utilisez H1 une fois pour le titre du document, H2 pour les sections principales et H3 pour les sous-sections. Gardez la hiérarchie propre, ne sautez pas les niveaux et écrivez un texte de titre descriptif. Lors de la conversion de documents Word avec WordToMD, assurez-vous que la source utilise les styles d'en-tête intégrés de Word pour une conversion propre.