Skip to main content

À propos de l'écriture et de la mise en forme sur GitHub

GitHub combine une syntaxe pour la mise en forme du texte appelée GitHub Flavored Markdown avec quelques fonctionnalités d'écriture uniques.

Qui peut utiliser cette fonctionnalité ?

Markdown can be used in the GitHub web interface.

Markdown est un langage facile à lire et à écrire pour mettre en forme du texte brut.

Nous avons ajouté des fonctionnalités personnalisées pour créer un Markdown adapté à GitHub, utilisé pour mettre en forme la prose et le code sur notre site.

Vous pouvez également interagir avec d'autres utilisateurs dans des demandes de tirage et des problèmes en utilisant des fonctionnalités telles que @-mentions, des références de problème et de demande de tirage et des emojis. Pour plus d'informations, consultez « Syntaxe de base pour l’écriture et la mise en forme ».

Barre d'outils de mise en forme de texte

Chaque champ de commentaire sur GitHub contient une barre d'outils de mise en forme de texte, qui vous permet de mettre en forme votre texte sans apprendre la syntaxe Markdown. Outre la mise en forme Markdown comme les styles gras et italique et la création d'en-têtes, de liens et de listes, la barre d'outils inclut des fonctionnalités spécifiques de GitHub, telles que @-mentions, des listes de tâches et des liens vers des problèmes et des demandes de tirage.

Activation des polices de largeur fixe dans l'éditeur

Vous pouvez activer une police de largeur fixe dans chaque champ de commentaire sur GitHub. Chaque caractère d'une police à largeur fixe, ou monospace, occupe le même espace horizontal. Cela peut faciliter la modification de structures Markdown avancées telles que des tables et des extraits de code.

Capture d'écran d'un commentaire GitHub montrant un exemple de table Markdown répertoriant deux commandes Git. Toutes les lettres du tableau ont la même largeur visuelle.

  1. Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil, puis sur Paramètres .
  2. Dans la barre latérale gauche, cliquez sur Apparence.
  3. Sous « Préférence de police de l'éditeur Markdown », sélectionnez Utiliser une police de largeur fixe (monospace) lors de l'édition de Markdown.
    Capture d'écran des paramètres utilisateur GitHub pour la préférence de Markdown. La case à cocher permettant d'utiliser une police à largeur fixe dans le Markdown est cochée et tracée en orange foncé.

Pour aller plus loin