Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.
All products
GitHub Pages

Définition d’un processeur Markdown pour votre site GitHub Pages avec Jekyll

Vous pouvez choisir un processeur Markdown pour déterminer comment Markdown est rendu sur votre site GitHub Pages.

GitHub Pages est disponible dans les dépôts publics avec GitHub Free et GitHub Free pour les organisations, et dans les dépôts publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server. Pour plus d’informations, consultez « Produits de GitHub ».

Les personnes disposant d’autorisations en écriture sur un dépôt peuvent définir le processeur Markdown pour un site GitHub Pages.

GitHub Pages prend en charge deux processeurs Markdown : kramdown et le propre processeur Markdown de GitHub, qui est utilisé pour restituer GitHub Flavored Markdown (GFM) dans GitHub. Pour plus d’informations, consultez « À propos de l’écriture et de la mise en forme sur GitHub ».

Vous pouvez utiliser GitHub Flavored Markdown avec l’un ou l’autre processeur, mais seul notre processeur GFM correspond toujours aux résultats que vous voyez sur GitHub.

  1. Dans GitHub, accédez au dépôt de votre site.
  2. Dans votre dépôt, accédez au fichier _config.yml.
  3. En haut à droite de la vue de fichier, cliquez sur pour ouvrir l’éditeur de fichier. Capture d’écran d’un fichier. Dans l’en-tête, un bouton avec une icône de crayon est indiqué en orange foncé.

Remarque : Au lieu de modifier et de commiter le fichier en utilisant l’éditeur de fichier par défaut, vous pouvez aussi utiliser l’éditeur de code github.dev en sélectionnant le menu déroulant et en cliquant sur Ouvrir dans github.dev.

Capture d’écran d’un fichier. Dans l’en-tête, une icône de triangle orientée vers le bas est indiquée en orange foncé.

4. Recherchez la ligne qui commence par `markdown:` et remplacez la valeur par `kramdown` ou `GFM`. ![Markdown setting in config.yml](/assets/images/help/pages/config-markdown-value.png) 1. Cliquez sur **Valider les modifications...** 1. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « [AUTOTITLE](/pull-requests/committing-changes-to-your-project/creating-and-editing-commits/creating-a-commit-with-multiple-authors) ». 1. Si vous avez plusieurs adresses e-mail associées à votre compte sur GitHub.com, cliquez sur le menu déroulant d’adresses e-mail et sélectionnez l’adresse e-mail à utiliser comme adresse e-mail de l’auteur Git. Seules les adresses e-mail vérifiées apparaissent dans ce menu déroulant. Si vous avez activé la confidentialité de l’adresse e-mail, `@users.noreply.github.com` est l’adresse e-mail par défaut de l’auteur de commit. Pour plus d’informations, consultez « [AUTOTITLE](/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-email-preferences/setting-your-commit-email-address) ». 
![Capture d’écran d’une demande de tirage GitHub montrant un menu déroulant avec des options permettant de choisir l’adresse e-mail de l’auteur du commit. octocat@github.com est sélectionné.](/assets/images/help/repository/choose-commit-email-address.png) 1. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « [AUTOTITLE](/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) ».

Capture d’écran d’une demande de tirage GitHub montrant une case d’option permettant de commiter directement dans la branche main ou de créer une branche. Une nouvelle branche est sélectionnée. 1. Cliquez sur Valider les modifications ou Proposer des modifications.

Pour aller plus loin