Le format Markdown
Le Markdown est un langage de balisage léger créé pour permettre d'écrire du texte structuré de manière lisible, tant pour les humains que pour les machines. Inventé en 2004 par John Gruber, il est devenu le standard pour la rédaction de documentation, de fichiers README sur GitHub, de messages sur des plateformes comme Reddit ou Discord, et même pour la prise de notes.
Son but est simple : vous permettre de mettre en forme votre texte (titres, gras, listes, liens) en utilisant uniquement des caractères spéciaux simples que vous trouvez sur votre clavier, sans avoir besoin de boutons complexes ou de code HTML lourd.
Pourquoi évoquer Markdown sur la Promptothèque ?
Parce que, à l'instar de Monsieur Jourdain qui fait de la prose sans le savoir, vous produisez des contenus utilisant ce format à chaque fois que vous utilisez le PIAG ou n'importe quel autre agent conversationnel IA (MistrAI, Assistant IA, ...). C'est le format natif des réponses à vos prompts !
Il suffit pour s'en convaincre de faire le test suivant :
- Rédigez un prompt puis exécutez-le sur le PIAG
- cliquez sur l'icone de copie en bas à gauche de la réponse
- ouvrez un nouveau document dans Word ou Bloc-notes (Notepad ou Notepad++) et collez le contenu récupéré dans le PIAG
Vous verrez que le texte qui apparaissait en gras est désormais entouré de "**", les hyperliens apparaissent entre crochets, etc.
Eh bien ça, c'est du Markdown!
À quoi cela sert-il ?
L'utilité du Markdown réside essentiellement dans sa polyvalence et sa lisibilité :
- Rédaction web : Il est souvent converti automatiquement en HTML pour afficher des pages web propres.
- Documentation technique : C'est le format roi pour expliquer le fonctionnement de logiciels (fichiers
.md). - Communication : De nombreuses applications de chat et de gestion de projet (comme Slack, Trello, ou kChat) interprètent le Markdown pour mettre en valeur les messages.
- Prise de notes : Il permet de structurer rapidement des idées sans quitter le clavier.
Les Instructions Essentielles
Voici les commandes de base à connaître pour maîtriser 90 % des besoins courants.
1. Les Titres
Utilisez des dièses # pour définir la hiérarchie. Plus il y a de dièses, plus le titre est petit.
# Titre principal (H1)
## Sous-titre (H2)
### Sous-sous-titre (H3)
2. Le Style de texte
Pour mettre en valeur des mots au milieu d'une phrase.
**Texte en gras**
*Texte en italique*
~~Texte barré~~
`Code en ligne`
3. Les Listes
Pour énumérer des points, ordonnés ou non.
- Liste à puces (utilisez `-` ou `*`)
- Un autre élément
- Sous-élément (ajoutez 2 espaces avant le tiret)
1. Liste numérotée
2. Deuxième élément
4. Liens et Images
Pour naviguer ou illustrer.
[Lien vers Google](https://www.google.com)
5. Les Blocs de Code
Pour afficher du code informatique proprement, avec une coloration syntaxique optionnelle.
print("Bonjour le monde")
Quels sont les éditeurs de Markdown à ma disposition?
Vous êtes utilisateur du Bnum ?
Sachez que vous pouvez produire un document nativement Markdown en cliquant, dans la partie "Documents", sur "Nouveau fichier texte".
Vous utilisez la Suite numérique et Docs?
Docs sait lire le format Markdown et vous pouvez aussi copier le contenu de votre document dans ce format (cliquez sur "..." en chaut à droite)
Un outil bien pratique : le Pad de l'Etat
Basé sur l'outil libre Hedgedoc, l'interface vous propose un mode mixte édition/visualisation, très pédagogique pour apprendre à maîtriser ce format, car on voit tout de suite le résultat obtenu!
Où trouver de la documentation ?
Si vous souhaitez approfondir ou chercher une syntaxe spécifique, voici les références les plus fiables :
- La référence officielle (Daring Fireball) : Le site original de John Gruber qui définit la syntaxe de base.
- Markdown Guide (markdownguide.org) : Un site tiers très pédagogique qui recense toutes les extensions possibles du langage.
- Markdown sur le site des aides : vous trouverez ici un certain nombre de liens vers différentes pages détaillant la syntaxe Markdown, mais aussi un petit "studio Markdown" qui peut vous être grandement utile...
En résumé, le Markdown est l'outil idéal pour écrire proprement et rapidement. Une fois les quelques symboles de base mémorisés, vous ne pourrez plus vous en passer !