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.

Tableaux

Des tableaux peuvent être créés simplement avec le format Markdown. Par exemple :

Nom     |   Age
--------|------
Julie   |   29
Lionel  |   47
Martin  |   32
Nom Age
Julie 29
Lionel 47
Martin 32

Les possibilités habituelles de formatage s'appliquent au contenu des cellules. Vous pouvez aligner les colonnes à gauche ou à droite en ajoutant un | à la gauche ou à la droite de la ligne horizontale (voir indications complémentaires).

Listes de définitions

À l'instar d'un dictionnaire, une liste de définitions comporte des termes suivis de leur définition. Par exemple :

Moodle
:   plate-forme de formation en ligne réputée

PHP
:   Langage de programmation de scripts.
    Principalement utilisé pour le développement d'applications web.
Moodle
plate-forme de formation en ligne réputée
PHP
Langage de programmation de scripts. Principalement utilisé pour le développement d'applications web.

Notes de bas de page

Une note de bas de page comporte deux éléments. Un renvoi, au sein du texte, qui apparaîtra sous forme la forme d'un exposant, et le contenu de la note qui se trouvera à la fin du document. Par exemple :

Ce point est abordé dans mon livre.[^1]

[^1]: Les références de mon livre.

Le contenu des notes peut être placé n'importe où. Les notes suivront l'ordre de leur apparition dans le texte. On ne peut créer qu'un lien vers chaque note.

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.

Affichage de code HTML ou de 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/.

Moodle utilise une version enrichie du format Markdown, connue sous le nom de « Markdown Extra ». Pour en savoir plus, reportez-vous à http://www.michelf.com/projects/php-markdown/extra/.

Index général de l'aide