Page de démonstration
Voici sur cette page plusieurs exemples de ce qu'il est possible d'obtenir avec mkdocs et le thème materials.
Sources
- Le site du thème Material pour MkDocs.
- markdown-cheatsheet.md
- La page Github de Eric Morlaix.
- L'éditeur markdown en ligne StackEdit.io
Mises en formes de base
Pour mettre un texte en gras, il suffit d'entourer ce texte de 2 étoiles **
.
Pour mettre un texte ex italique, il faut entourer ce texte d'une étoile *
.
Pour mettre un texte en gras ET en italique, il faut insérer **_
avant et _**
après.
Pour barrer du texte comme ceci entourer ce texte de 2 ~~
.
Pour souligner du texte, ajouter ^^
avant et après.
Insérer un lien
La méthode Markdown régulière est d'écrire le texte qui sera visible entre crochets et le lien entre parenthèses comme dans cet exemple
[Lien vers Google](https://www.google.fr) |
Résultat : Lien vers Google |
---|---|
Admonitions
Voici tout d'abord une présentation de la fonction Admonitions.
Cela permet d'insérer un bloc afin de mettre en valeur un texte. Pour cela, il suffit de commencer une ligne par "!!!"
Exemple :
Note avec un titre personnalisé
Contenu de la note.
Puis le texte continue.
!!! Note "Note avec un titre personnalisé"
Contenu de la note.
Puis le texte continue.
Il existe plusieurs types de cadres : Question, failure, danger... Plus d'infos ici
Ce cadre est à droite grace à la commande inline end
Contenu du cadre
sur plusieurs lignes
en ajoutant 2 espaces
à la fin de chaque ligne
!!! tip inline end "Ce cadre est à droite grace à la commande ***inline end***"
Contenu du cadre
sur plusieurs lignes
en ajoutant 2 espaces
à la fin de chaque ligne
Insérer un bouton
Lien dans un bouton
Ce qui affiche ceci : Page d'accueil
Bouton avec une icône
[:incoming_envelope: *Envoie-moi !* :fontawesome-solid-shuttle-space:](https://mkdocs.fabzh.eu){ .md-button }
Ce qui donne cela :
Barres de progressions
Voici un essai de barre de progression :
70%