Document ID: /fineweb-2-swissfilter-quality_10-filterrobots/filtered/06860.jsonl.gz/124

Utilisation avancée du format Markdown
Cette section vous complète les informations sur le formattage de texte avec le format Markdown. Si le formattage décrit ici ne vous est pas familier ou si vous n'en avez pas besoin, vous pouvez sans dommage sauter le reste de ce texte et y revenir au besoin.
Dans certains textes, par exemple dans les poèmes, il est nécessaire d'insérer des fins de lignes. Si vous essayez de le faire avec la touche retour de votre clavier, vous n'obtiendrez pas l'effet désiré, car par défaut les lignes seront accolées pour faire un même paragraphe.
En tapant les vers ci-dessus, avec la touche retour pour insérer des fins de ligne, vous obtiendrez ceci, puisque les fins de ligne seront ignorés :
Maître Corbeau, sur un arbre perché, Tenait en son bec un fromage. Maître Renard, par l'odeur alléché, Lui tint à peu près ce langage.
En revanche, en terminant chaque ligne par 2 espaces, vous pourrez forcer une fin de ligne pour obtenir ceci :
Maître Corbeau, sur un arbre perché,
Les filets horizontaux peuvent être créés en tapant trois ou quatre astérisques (*), tirets (-) ou caractères soulignés (_) tous seuls sur une ligne.
Le code suivant fonctionnera :
mais vous pouvez ajouter des espaces ou plus de mêmes caractères pour rendre plus visible un saut de section dans la fenêtre d'édition du texte, par exemple
Toutes ces méthodes donneront exactement le même résultat :
Le document Enrichir des textes avec le format Markdown donne des instructions pour créer des liens web et insérer des images. Mais il n'est pas spécialement évident de combiner liens et images pour créer des images cliquables.
Ci-dessus sont présentés un lien web standard et une image. En plaçant l'image là où devrait être le texte du lien, on obtient ceci :
La ligne ci-dessus, combinée avec les définitions suivantes ailleurs dans le document :
donne l'image cliquable (avec titre dans une bulle) ci-dessous :
Un exemple d'utilisation futée de cette technique est de lier des petites vignettes vers le téléchagement d'images plus grandes.
Si vous connaissez bien le code HTML, vous pouvez l'utilisez dans les cas où Markdown ne suffirait pas. Markdown est en effet conçu dans cette éventualité et vous permet d'incorporer directement du code HTML dans le texte.
Remarquez que le code HTML coexiste avec le code Markdown des listes. Cela vous permet de vous libérer de tâches fastidieuses d'écriture de code HTML complexe pour du formattage de base tout en vous permettant d'accéder à toute la puissance du HTML dans des cas spécifiques.
Si contrairement à la section ci-dessus, vous désirez afficher du code HTML exactement comme il est tapé, plutôt que de faire afficher son interprétation, vous commencerez chaque ligne par quatre espaces.
Ceci fonctionne également pour afficher de la programmation :
Comme ce formattage est souvent utilisé dans des listings de programmes et d'autres textes contenant probablement des caractères utilisés par Markdown pour indiquer différents types de formattage, le format Markdown est désactivé dans ces lignes :
Pour inclure de tels caractères dans du texte normal, voir la section suivante.
Si vous voulez utiliser l'un des caractères spéciaux utilisés par Markdown pour le formattage du texte sans qu'il ne soit interprété, il vous suffit de le précéder par une barre oblique inversée (backslash \). Cette méthode est appelée échappement d'un caractère. La barre oblique inversée ne sera pas affichée, mais le caractère qui la suit immédiatement sera affiché tel qu'il a été tapé.
devient
*astérisques, pas accentuation*
au lieu de
qui donne
accentuation, pas astérisques
Le format Markdown n'est pas propre à Moodle. Il est utilisé dans un grand nombre d'autres outils de publication web. Vous trouverez plus d'informations à ce sujet sur http://daringfireball.net/projects/markdown/.