Bonjour à toutes et à tous,

Je me suis intéressé il y a peu à la façon dont pouvait être mis en forme (pour plus de clarté/lisibilité dans les échanges) les textes des questions/réponses de ce forum.

Ce qu'il faut savoir, c'est que ce qui est utilisé ici , c'est le langage de balisage MarkDown, dont la fiche wikipedia -assez claire- se trouve ici

À noter que les langages de balisage ne sont pas des langages de programmation. Ils ont pour vocation de structurer de façon simple la mise en page d'un texte.

J'ai lu ici que "Le nom « Markdown » est en fait un jeu de mots. Le terme anglais désignant les langages de balisage est « Markup Languages ». Le nom Markdown signifie clairement qu’on a affaire à un langage simplifié et léger, d’où l’appellation : Markdown" (fin de citation)

Pour l'instant, il me semble que l'ensemble des balises de mise en forme ne sont pas ici toutes possibles (peut-être une restriction de la part des créateurs/administrateurs de ce forum, je ne sais pas, et je poserai à l'occasion une question sur le formulaire de contact avec les développeurs, ils ne répondront sans doute pas, mais je n'ai pas encore la lassitude des 'non réponses', donc j'essayerai)

Ces remarques liminaires étant faites, venons-en à ce mémento simplifié.

Voici les principales balises que j'ai pu identifier :

1. A noter tout de suite que dans ce qui suit, lorsque j'indique les caractères d'un balisage, pour qu'il ne soit pas interprété il me faut taper 4 espaces avant d'écrire (ou un peu plus compliqué il faut encadrer le texte par un accent grave (en anglais backtick), par défaut AltGr + 7 sur les claviers AZERTY français, sur un ordinateur de marque Apple c'est la touche au-dessus de la Livre Sterling)

C'est donc une première balise. Celle qui permet de ne pas interpréter du 'code' (=balise ici)

2. La mise en gras s'effectue encadrant le texte/mot par 2 **
   Par exemple **Bonjour** se lira Bonjour

3. La mise e, italique s'effectue en encadrant le texte/mot par 1 seul * ou 1 seul _ (caractère underscore)
   Par exemple *Bonjour* se lira Bonjour ou _Bonjour_ se lira aussi Bonjour

4. A fortiori, une des 2 façons de mise en italique et en gras devra encadrer le texte par ***
   Par exemple ***Bonjour*** se lira Bonjour

5. Je n'ai pas trouvé le balisage pour un mot barré (pourtant il existe bien mais n'est pas opérant ici) ni le souligné. J'ai lu que le souligné n'était pas géré par MarkDown

6. Une liste à puces est possible avec un seul * devant chaque ligne se terminant par un Return au clavier
   Par exemple : * liste 1 puis return puis * liste 2 puis à nouveau return donnera :

* liste 1
* liste 2

On peut aussi prévoir des sous-éléments avec 6/ plus 4 espaces devant.

• liste 1
• liste 2
  sous éléments 2a (là j'ai placé 4 espaces devant 'sous éléments 2a')
  sous éléments 2b

7. Les titres, titre de niveau 2, de niveau 3 s'obtiennent en commençant chaque ligne par # puis ## puis ### et ainsi de suite

Ce qui donnera :

Titre principal (1er niveau)

Sous titre (2ème niveau)

Troisième niveau

8. Un trait de séparation dans le texte s'obtient en tapant 3 traits pointillés sur ---

Par exemple :

9. Astuce pour mettre en place un bloc de citation (comme dans les courriel par exemple); copier la partie où vous voulez réagir, encadrez la par "* et cela donnera l'illusion d'un bloc de citation (normalement le balisage markdown le permet, mais cela ne semble pas fonctionner pour ce forum ).

10. Les liens cliquables. Il suffit d'utiliser la syntaxe suivante : `[Nom du Site](url du site)`
    

Par exemple pour faire un lien sur ce forum, on écrira [Forum MuseScore en français](https://musescore.org/fr/forum) ce qui donnera :
Forum MuseScore en français

11. Pour les images, même syntaxe que ci-dessus mais il est prévu une insertion d'image à partir d'un téléchargement dans le forum. Pour les emails, même syntaxe que pour le 10.

A noter que le forum prévoit une instruction de type ìnline`

12. Le caractère `©` s'obtient en tapant &copy
    

    ce qui donne ©

13. Tableau : on tapera, je vous renvoie vers votre clavier pour taper le caractère | s'obtient, sur le Mac que j'utilise il s'obtient en tant simultanément les touches option + Majuscule + L (pour un PC a priori ce serait Alt+ 0124, mais c'est à vérifier)

| 1ère colonne | 2ème colonne |
| ------------- | ------------- |
| Cellule 1.1 | Cellule 1.2 |
| Cellule 2.1 | Cellule 2.2 |

et cela donnera :

Voilà j'en resterai là pour ce qui est le plus usuel. Il y a sans doute d'autres balises qui peuvent fonctionner ici comme la coloration, mais je ne pousserai pas la recherche dans ces domaines qui tout au contraire pourraient rendre illisibles les textes.

SI vous en voyez d'autres et tant que ce billet pourra être modifié -, je les rajouterai et le cas échéant je verserai ce mémento simplifié dans la section How To.