Document ID: /fineweb-2-swissfilter-quality_10-filterrobots/filtered/06867.jsonl.gz/325

Enrichir des textes avec le format Markdown
Le format Markdown étend le simple mode de saisie de texte disponible dans Moodle en vous permettant d'ajouter facilement des accentuations (gras, italique), de la structure (points de listes et titres) et des liens (vers des images ou d'autres ressources web). Vous pouvez utiliser Markdown à de nombreux endroits de Moodle, en sélectionnant simplement ce format dans le menu déroulant Format, que l'on trouve au-dessous de la zone de texte lorsque vous avez le choix.
Pour saisir du texte, tapez simplement dans la zone de texte, en pressant deux fois sur la touche retour à la fin d'un paragraphe, pour insérer une ligne vide entre la fin d'un paragraphe et le début du suivant.
Il est possible d'accentuer du texte de trois façons, avec Markdown : texte en italique, texte en gras et texte en gras et italique. Pour obtenir ces accentuations, vous entourez le texte en question par des astérisques, de la façon suivante :
On peut accentuer de simples mots, une suite de mots ou même des parties de mots :
Des caractères soulignés (_) peuvent être utilisés en lieu et place des astérisques pour le même résultat.
Markdown vous permet de subdiviser votre texte avec des titres et sous-titres. Six différents niveaux sont disponibles, bien qu'il soit inhabituel d'en utiliser plus de trois dans un texte normal. Par exemple, il y a trous niveaux de titres dans le texte que vous lisez maintenant.
Vous pouvez créer un titre en commençant une ligne avec un ou plusieurs caractères dièze (#). Un seul dièze donne le niveau de titre le plus élevé, et six dièzes le niveau le moins important.
Les deux premiers niveaux de titres sont les plus utilisés et peuvent aussi être créés d'un autre façon pour les faire ressortir dans la version non formattée du texte (même si l'aspect formatté est le même qu'avec la méthode précédente). Cette méthode alternative utilise une ligne de signes égal (=) ou de tirets (-) sous le texte du titre, de cette façon :
Listes de points
Les listes de points peuvent être créées en commençant chacune des lignes concernées par un astérisque, suivi d'un espace avant le contenu de l'élément de la liste. L'espace est important et ne doit pas être oublié.
devient
Listes numérotées
De façon analogue, les listes numérotées peuvent être créées en commençant chacune des lignes concernées par un chiffre et un point, suivi d'un espace avant le contenu de l'élément de la liste.
devient
Listes imbriquées
L'on peut imbriquer les listes de points ou numérotées, en les mélangeant au besoin dans la même structure :
* point un, niveau un * niveau deux * point deux, niveau deux * point deux, niveau un 1. point un, liste numérotée 1. point un, niveau deux liste numérotée 2. point deux, liste numérotée
devient
Vous pouvez indiquer une section de citation de texte en commençan chaque ligne avec un signe plus rand que (>). Ce caractères a été choisi dans de nombreux programmes de courriel pour indiquer le texte cité. La sortie formattée sera en général en retrait par rapport au texte normal.
devient
Il est possible de vous épargner la saisie de texte en ne tapant qu'un signe plus grand que au début de la première ligne du paragraphe, ainsi :
devient
Il y a deux façons de créer des liens vers des ressources web : la première est de taper directement l'URL entre parenthèses, et de le précéder immédiatement (sans espace) du texte devant être affiché à sa place entre crochets ; un titre peut être optionnellement adjoint entre guillemets après l'URL.
devient
Un exemple de lien dans une phrase.
Le titre, s'il est fourni, est affiché dans une bulle lorsque le pointeur reste au-dessus du texte du lien. Essayez sur le lien ci-dessus.
Pour des liens plus long, on peut utiliser une notation style note de bas de page, en donnant un nom bref (un simple mot ou un nombre) identifiant le lien entre deux crochets supplémentaires.
Puis, n'importe où ailleurs dans le document, mais de préférence directement à la suite du paragraphe contenant le lien, ou rassemblé au bas du document en tant que liste de liens, vous définirez les URLs associés aux différents identifiants :
L'effet produit par ce deuxième exemple est exactement le même que le premier. Ce type de notation est surtout utile pour garder une bonne vue d'ensemble du document en travail, notamment pour permettre de le retravailler facilement dans une phase ultérieure, par exemple si l'on y travaille à plusieurs.
Une dernière méthode est de typer simplement l'URL entre deux signes plus grand que et pls petit que, si vous désirez que l'URL apparaisse comme texte du lien :
devient
Les images sont incluses de façon très similaire aux liens web. La seule différence est que la notation est précédée d'un point d'exclamation. Le texte alternatif étant fourni aux utilisateurs ne pouvant voir l'image pour diverses raisons, il doit donner une information sur le contenu ou le but de l'image. Il donnera en outre dans ce cas une indication supplémentaire sur l'image aux autres personnes modifiant le texte.
Le titre, s'il est fourni, est affiché dans une bulle lorsque le pointeur reste au-dessus du texte du lien.
Tout comme pour les liens web, vous pouvez organiser votre document en gardant rassemblées toutes les références en style note de bas de page. Donnez alors un simple mot ou nombre comme identifiant de l'image :
et n'importe où dans le document, faites l'association entre le nom et le fichier de l'image :
Voici un exemple et l'affichage du résultat :
Le texte alternatif, important pour des raisons d'accessibilité, sera souvent utilisé par les navigateurs pour remplacer une image dont le lien est cassé ou qui n'est pas disponible actuellement :
devient (l'affichage exact dépend de votre navigateur)
Cette brève introduction couvre les fonctions les plus fréquemment utilisées du format Markdown. Il est possible d'obtenir de résultats plus complexes, notmamment si vous connaissez le format HTML. Ces aspects sont traités dans le document Utilisation avancée du format Markdown.