Définition d’un processeur Markdown pour votre site GitHub Pages à l’aide de Jekyll

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

Qui peut utiliser cette fonctionnalité ?

GitHub Pages est disponible dans les référentiels publics avec GitHub Free et GitHub Free pour les organisations, et dans les référentiels publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server.

Remarque

Bien que la gemme github-pages soit toujours pris en charge pour certains workflows, GitHub Actions est désormais l'approche recommandée pour déployer et automatiser les sites GitHub Pages.

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 supporte deux processeurs Markdown : kramdown et le propre processeur Markdown de GitHub, qui est utilisé pour rendre 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 le Markdown enrichi de GitHub avec l’un ou l’autre des processeurs.

  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é.

  4. Recherchez la ligne qui commence par markdown: et remplacez la valeur par kramdown ou GFM. La ligne complète devrait indiquer markdown: kramdown ou markdown: GFM.

  5. Cliquez sur Commiter les changements.

  6. 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 « Création d'un commit avec plusieurs auteurs ».

  7. 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 « Création d’une 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.

  8. Cliquez sur Valider les modifications ou Proposer des modifications.

Pour aller plus loin