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éfacer 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 :
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 :
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 :
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 !
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 !
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.
Mélanger le saumon dans le bol avec les oeufs et le lait.
Voici quelques techniques sur le mélange du saumon
Pour créer ce type de texte, votre paragraphe doit commencer sur une ligne toute seule. 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 Markdown. comme des citations, ou même d'autres listes !
Dans l'encadré ci-dessous, convertissez les puces en leurs propres paragraphes.