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.

Fins de ligne

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.

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 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é,
Tenait en son bec un fromage.
Maître Renard, par l'odeur alléché,
Lui tint à peu près ce langage.

Filets horizontaux

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 :

Images liées

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.

[le moteur de recherche][google]

![le logo google][logo]

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 :

[![le logo google][logo]][google]

La ligne ci-dessus, combinée avec les définitions suivantes ailleurs dans le document :

[logo]: http://www.google.com/images/logo.gif
[google]: http://www.google.com/ "Cliquer pour visiter Google"

donne l'image cliquable (avec titre dans une bulle) ci-dessous :

le logo google

Un exemple d'utilisation futée de cette technique est de lier des petites vignettes vers le téléchagement d'images plus grandes.

Incorporer du code HTML

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.

* <small>texte petit</small>
* <big>texte grand</big>

  • texte petit
  • texte grand

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.

Code préformatté

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.

<p>Un paragraphe en <b>HTML</b> affiché comme du code</p>

Ceci fonctionne également pour afficher de la programmation :

print "Arguments passés : (@ARGV)\n";

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 :

Normalement, ce mot devrait être en **gras**.

Pour inclure de tels caractères dans du texte normal, voir la section suivante.

Utilisation de caractères spéciaux

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é.

\*astérisques, pas accentuation\*

devient

*astérisques, pas accentuation*

au lieu de

*accentuation, pas astérisques*

qui donne

accentuation, pas astérisques

Pour en savoir plus

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/.

Index général de l'aide