Balises de Code Markdown


Utilisation Courante

Lors de la création de votre projet Mkdocs, l'utilisation de balises de code Markdown est une pratique fréquente. Voici quelques exemples concrets pour vous aider à comprendre leur application :

# Exemple d'utilisation de la balise ```yaml```
theme:
  name: dsfr

plugins:
  - search
  - dsfr-plugin

Personnalisation de highlightjs

Si vous souhaitez ajuster la version ou le thème par défaut, il vous suffit d'ajouter le paramètre highlightjs dans le fichier mkdocs.yml , comme illustré ci-dessous :

# Configuration du Thème
theme:
  name: dsfr
  highlightjs:
    version: 11.10.0
    theme_light: base16/solar-flare
    theme_dark: base16/solar-flare-light
Nom Valeur par défaut Description
highlightjs.version 11.10.0 Version highlightjs
highlightjs.theme_light base16/solar-flare Theme highlightjs pour le light theme MkDocs DSFR
highlightjs.theme_dark base16/solar-flare-light Theme highlightjs pour le dark theme MkDocs DSFR

Exemple de modification de la configuration :

# Configuration du Thème
theme:
  name: dsfr
  highlightjs:
    version: 11.9.0
    theme_light: github-dark
    theme_dark: github

Pour découvrir des exemples de thèmes disponibles, n'hésitez pas à consulter ce lien .