Tutoriel pour créer un site web facilement avec MkDocs

Ce tutoriel est conçu pour vous guider à travers les différentes étapes de la création de votre site web basé sur MkDocs. La mise en œuvre est très simple grâce à l'utilisation de fichiers écrits en Markdown.

Il existe un autre tutoriel plus spécialisé pour créer son site web avec Python et SQL intégré : Tutoriel pour site avec Python et SQL

Ce tutoriel

Que vous soyez débutant ou que vous ayez déjà quelques notions, ce guide vous accompagnera de manière progressive et détaillée.
Vous y trouverez des explications sur la configuration initiale, la personnalisation du design, l'ajout de contenu pédagogique, et les bonnes pratiques pour maintenir votre site à jour.

Chaque étape est illustrée avec des exemples concrets et des conseils pratiques pour vous aider à réussir votre projet web en toute simplicité.
Tous les exemples sont accompagnés de "code à copier" pour une intégration rapide dans votre site.

👉 Le modèle de site

Ce tutoriel accompagne le modèle suivant à cloner, pour aider à sa prise en main :

Rendu du site simple Dépôt du site simple à cloner

Attention : Mise à jour à effectuer si vous avez créé votre site avant le 02/01/2026

MAJ

Attention : Mise à jour à effectuer si vous avez créé votre site avant le 26/08/2024

MAJ

Un parcours pour construire votre site pas à pas

Parcours pas à pas

Les sites compatibles avec ce tutoriel pour les QCM

Votre site n'est pas forcément compatible avec ce tutoriel pour les QCM tels que décrits ici.

😥 Cliquer pour voir les sites non compatibles

Le contenu de ce tutoriel est inadapté si votre site a été construit sans pyodide ou à partir de l'ancienne version pyodide et n'a pas été mis à jour.

👉 MAJ

😊 Cliquer pour voir les sites compatibles

Le contenu de ce tutoriel est adapté si

• votre site a été construit à partir de l'ancienne version pyodide et a été mis à jour avec Pyodide Mkdocs Theme (par exemple ceci visible en bas du site à droite) :

👉 Le numéro de la version de Pyodide MkDocs Theme importe peu.

• ou s'il a été construit en utilisant le site modèle donné en haut de cette page.

👉 Cloner le modèle de site pour le personnaliser

Vous pouvez faire une bifurcation (on dit aussi un «fork») de ce modèle pour réaliser le vôtre.
Le tutoriel pour réaliser cette bifurcation est sur ce site, dans la rubrique "Comment créer un site à partir d'un autre".

Lien direct : Faire une «bifurcation» (fork en anglais)

👉 Si vous débutez et pour comprendre la structure

Il est conseillé de commencer par : Avant de démarrer

En bref

😀 Vous pourrez facilement recopier toutes les syntaxes depuis ce tutoriel.

Dernière mise à jour le 02/01/2026 - version 2.2.0