Les bases de rédaction en Markdown#
Ressources#
Compte-tenu de la popularité du Markdown, inutile de réinventer la roue, autant pointer vers les bonnes ressources déjà disponibles en ligne :
La syntaxe#
Le markdown est une syntaxe extensible et son rendu dépend de l'outil utilisé pour l'implémenter. Il existe donc des différences entre le rendu :
- dans l'onglet
Preview
de [GitHub], - celui dans un éditeur [Visual Studio Code]
- celui de l'outil utilisé pour le rendu final MkDocs / Material.
C'est ce dernier qui fait foi.
Tip
Pour comprendre comment fonctionne le rendu des contenus, consulter l'article dédié.
Bien démarrer#
- rédiger en Markdown (OpenClassrooms)
- un guide pour bien commencer avec Markdown
- Mastering Markdown (GitHub)
Aller plus loin#
Editeurs#
N'importe quel éditeur de texte "plat" suffit pour rédiger en Markdown.
Bureautique#
En ligne#
Tip
Le choix du Markdown pour Geotribu a été détaillé dans l'article Du HTML au Markdown (et vice-versa). Il contient quelques éléments de compréhension sur la syntaxe et un petit TP pour s'exercer.
Prochaine étape : respecter et valider la syntaxe
Spécimen#
En plus des ressources, à suivre quelques exemples de base.
Titres et paragraphes#
1 2 3 4 5 6 7 |
|
Format#
1 2 3 4 5 6 7 8 9 10 11 |
|
Pour mettre en forme le texte, c'est facile. Il s'agit surtout de se souvenir que les retours à ligne et les retraits font loi dans la syntaxe.
Mettre un texte en italique avec une astérisque ou un underscores (autrement appelés tiret du 8) de chaque côté.
Mettre un texte en gras avec deux astérisques ou deux underscores (autrement appelés tiret du 8) de chaque côté.
Barrer un texte avec deux tildes de chaque côté.
Combiner les différents styles est possible. Ainsi on peut obtenir un texte en italique, un texte en italique et gras, un texte en italique et barré avec : un underscore, deux astérisques et deux tildes.
Listes à puces#
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
|
Liste numérotée à plusieurs niveaux :
- premier élément de la liste
- deuxième élément de la liste
- indenter avec 4 espaces avant le chiffre permet de faire des sous-listes imbriquées
- deuxième élément de second niveau
- troisième élément de la liste de 1er niveau qui contient une sous-liste non ordonnée :
- hip,
- hop,
Ou sans numéros :
- on peut créer des puces avec différents caractères :
- astérisque,
- tiret
- signe plus (+)
- mais, pour éviter les effets de bord (espacement de paragraphe, mauvais niveau de retrait...) et selon les règles établies, il est préférable de rester cohérent dans le caractère utilisé, au moins dans un même document
- en général, on utilise l'astérisque ou alors le tiret.
Prochaine étape : respecter et valider la syntaxe
Commentaires
Une version minimale de la syntaxe markdown est acceptée pour la mise en forme des commentaires.Propulsé par Isso.