Listes

Ce tutoriel concerne la création de listes en Markdown.

Il existe deux types de listes dans l'univers connu : non ordonnées et ordonnées. C'est une façon fantaisiste de dire qu'il y a des listes avec des puces, et des listes avec chiffres.

Pour créer une liste non ordonnée, vous voudrez préfacez chaque élément de la liste avec un astérisque ( *). Chaque élément de la liste a également sa propre ligne. Par exemple, une liste d'épicerie en Markdown pourrait ressembler à ça :

* Lait
* Oeufs
* Saumon
* Beurre

Cette liste en Markdown se traduirait par les puces suivantes :

Dans l'encadré ci-dessous, transformez les mots séparés par une virgule en une liste.


TrÚs bien ! C'est comme ça qu'on fait une liste non ordonnée. Maintenant, parlons de l'ordre ceux-là.

Une liste ordonnée est précédée de chiffres au lieu d'astérisques. Jetez un coup d'oeil à cette recette :

  1. Casser trois Ɠufs dans un bol
  2. Verser un litre de lait dans le bol
  3. MĂ©langer vigoureusement le saumon avec du beurre
  4. DĂ©poser le saumon dans le bol de lait avec les Ɠufs

Pour écrire ça en Markdown, vous noterez ça :

1. Casser trois Ɠufs dans un bol
2. Verser un litre de lait dans le bol
3. MĂ©langer vigoureusement le saumon avec du beurre
4. DĂ©poser le saumon dans le bol de lait avec les Ɠufs

Facile, n'est-ce pas ? C'est comme si on s'attendait Ă  ce qu'une liste Ă  lire.

Dans la boßte ci-dessous, transformez le reste de la recette en une liste ordonnée.


Quel travail fantastique !

Vous pouvez choisir d'ajouter des italiques, des caractÚres gras ou des liens dans les listes, comme vous pouvez vous y attendre. Dans l'encadré ci-dessous, transformez les noms latins des plantes en italiques.


Magnigique !

À l'occasion, vous aurez peut-ĂȘtre besoin de faire une liste plus dĂ©taillĂ©e ou d'imbriquer une liste dans une autre. N'ayez crainte, car la syntaxe Markdown est exactement la mĂȘme. Tout ce que vous avez Ă  faire est de ne pas oublier d'indenter chaque astĂ©risque d'un espace de plus que l'Ă©lĂ©ment prĂ©cĂ©dent.

Par exemple, dans la liste suivante, nous allons ajouter quelques sous-listes à chacune des "principals" élément de la liste, décrivant les gens en détail :

* Tintin
 * Un reporter
 * A des cheveux oranges touffus
 * Amis avec le chien le plus génial du monde
* Haddock
 * Un capitaine de navire
 * A une barbe fantastique
 * Adore le Whisky
   * Peut-ĂȘtre aussi le scotch ?

Lors de son rendu, cette liste devient le groupe suivant :

  • Tintin
    • Un reporter
    • A des chevehxy oranges touffus
    • Amis avec le chien le plus gĂ©nial du monde
  • Haddock
    • Un capitaine de navire
    • A une barbe fantastique
    • Adore le whisky
      • Peut ĂȘtre aussi le scotch ?

Dans la case ci-dessous, transformez les caractéristiques du personnage en sous-éléments.


StupĂ©fiant ! Alors que vous pouvez continuer Ă  indenter et ajouter des sous-listes indĂ©finiment, c'est gĂ©nĂ©ralement une bonne idĂ©e de s'arrĂȘter aprĂšs trois niveaux ; sinon, votre texte sera en dĂ©sordre.

Il y a une autre astuce pour les listes et les indentations que nous allons explorer, et qui concerne le cas des paragraphes. Supposons que vous vouliez créer une liste à puces qui nécessite un contexte supplémentaire (mais pas une autre liste). Par exemple, il pourrait ressembler à ça :

  1. Casser trois Ɠufs dans un bol.

    Maintenant, vous allez devoir casser les oeufs de telle sorte que vous ne fassiez pas de gĂąchis.

    Si vous faites du désordre, utilisez une serviette pour le nettoyer !

  2. Verser un gallon de lait dans le bol.

    En gros, suivez les mĂȘmes conseils que ci-dessus : ne soyez pas dĂ©sordonnĂ©, mais si vous l'ĂȘtes, nettoyez-le !

  3. Frotter vigoureusement le saumon avec du beurre.

    Par "vigoureux", on entend un mouvement strictement vertical. L'enfant de Julia s'est un jour moquée d'elle :

    De haut en bas et tout autour, c'est comme ça que le beurre va sur le saumon.

  4. MĂ©langer le saumon dans le bol avec les oeufs et le lait.

    Voici quelques techniques sur le mélange du saumon

    • S'assurer qu'il n'y a pas de truites ou d'enfants
    • utilisez vos deux mains
    • Ayez toujours une serviette Ă  proximitĂ© en cas de dĂ©gĂąts

Pour crĂ©er ce type de texte, votre paragraphe doit commencer sur une ligne tout seul. sous le point de la puce, et ça doit ĂȘtre dentelĂ©e d'au moins un espace. Par exemple, la liste ci-dessus ressemble Ă  ceci en Markdown :

    1. Casser trois Ɠufs dans un bol.

     Maintenant, vous allez devoir casser les oeufs de telle sorte que vous ne fassiez pas de gĂąchis.

     Si vous faites du désordre, utilisez une serviette pour le nettoyer !

    2. Verser un gallon de lait dans le bol.

     En gros, suivez les mĂȘmes conseils que ci-dessus : ne soyez pas dĂ©sordonnĂ©, mais si vous l'ĂȘtes, nettoyez-le !

    3. Frotter vigoureusement le saumon avec du beurre.

       Par "vigoureux", on entend un mouvement strictement vertical. L'enfant de Julia s'est un jour moquée d'elle :
       > De haut en bas et tout autour, c'est comme ça que le beurre va sur le saumon.
    4. MĂ©langer le saumon dans le bol avec les oeufs et le lait.

       Voici quelques techniques sur le mélange du saumon :

       * Assurez-vous qu'il n'y a pas de truites ou d'enfants
       * Utilisez vos deux mains
       * Ayez toujours une serviette à proximité en cas de désordre
  

Notez que les deux premiers Ă©lĂ©ments ont un seul espace. Ça a l'air un peu bizarre, donc vous pourriez vouloir indenter correctement pour faire correspondre les caractĂšres vers le haut (comme les Ă©lĂ©ments trois et quatre). Dans ces paragraphes, vous pouvez inclure toutes sortes d'autres dĂ©marques. comme des citations, ou mĂȘme d'autres listes !

Dans l'encadré ci-dessous, convertissez les puces en leurs propres paragraphes.


Vous savez maintenant comment faire des listes en Markdown !

A la prochaine leçon !