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.

Concept de base

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.

Accentuer du texte

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 :

*italique* -> italique
**gras** -> gras
***gras italique*** -> gras italique

On peut accentuer de simples mots, une suite de mots ou même des parties de mots :

un *unique* mot -> un unique mot
***une suite de mots*** -> une suite de mots
il**lisi**ble -> illisible

Des caractères soulignés (_) peuvent être utilisés en lieu et place des astérisques pour le même résultat.

Titres

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.

# Titre de section
## Titre de sous-section
### Titre de sous-sous-section
etc.

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 :

Titre de section
===============

Titre de sous-section
------------------

Listes

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

* premier point
* deuxième point
* troisième point

devient

  • premier point
  • deuxième point
  • troisième point

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.

1. Premier point
2. Deuxième point
3. Troisième point

devient

  1. Premier point
  2. Deuxième point
  3. Troisième point

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

  • 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

Paragraphes de citations

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.

> Une citation sur
> deux lignes

devient

Une citation sur deux lignes

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 :

> ceci est le texte
d'une unique citation, même si elle est
présentée sur plusieurs lignes.

devient

ceci est le texte d'une unique citation, même si elle est présentée sur plusieurs lignes.

Liens web

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.

Un [exemple de lien](http://exemple.fr/ "Titre optionnel") dans une phrase.

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.

Un [exemple de lien][ex] dans une phrase.

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 :

[ex]: http://exemple.fr/ "Titre optionnel"

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 :

<http://moodle.org/>

devient

http://moodle.org

Images

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.

![texte alternatif](/chemin/image.jpg "Titre optionnel")

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 :

![texte alternatif][photo]

et n'importe où dans le document, faites l'association entre le nom et le fichier de l'image :

[photo]: /url/de/image.jpg "Titre optionnel"

Voici un exemple et l'affichage du résultat :

![Logo Google](http://www.google.com/images/logo.gif "Le logo Google")

Logo Google

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 :

![Texte alternatif d'une image non disponible](http://exemple.com/lien-cassé-intentionnellement "Cette image ne sera jamais affichée")

devient (l'affichage exact dépend de votre navigateur)

Texte alternatif d'une image non disponible

Utilisation avancée

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.

Utilisation avancée du format Markdown

Index général de l'aide