Markdown est un langage simple conçu pour simplifier la rédaction de contenu. Il est utilisé partout, de GitHub aux applications de prise de notes. Que vous soyez écrivain, développeur, ou simplement quelqu’un qui souhaite simplifier votre écriture web, ce guide est pour vous !
Markdown est un langage de balisage léger, créé par John Gruber en 2004, pour rendre le texte formaté facilement lisible dans les éditeurs de texte brut. Il est particulièrement populaire pour le blogging, la messagerie instantanée, les forums, les outils collaboratifs, la documentation et les fichiers readme. Avec le temps, des variations dans son interprétation ont conduit à la création de CommonMark en 2014, une spécification plus claire avec une suite de tests pour garantir une mise en œuvre cohérente.
Voici un aperçu rapide des éléments les plus courants que vous utiliserez :
Les en-têtes sont créés en utilisant le symbole #
, suivi d’un espace :
# Ceci est un H1
## Ceci est un H2
### Ceci est un H3
Pour l’italique, utilisez *astérisques*
ou _tirets bas_
.
Pour le gras, utilisez **double astérisques**
ou __double tirets bas__
.
Utilisez des astérisques, des plus, ou des moins suivis d’un espace :
* Élément 1
* Élément 2
* Sous-élément 2.1
* Sous-élément 2.2
Utilisez simplement des chiffres suivis de points :
1. Premier élément
2. Deuxième élément
3. Troisième élément
Vous pouvez créer un lien en ligne avec la syntaxe suivante :
[Texte affiché](URL "Titre facultatif")
Les images sont similaires aux liens mais avec un point d’exclamation précédent :
![Texte alternatif](URL "Titre facultatif")
Pour les citations, utilisez le caractère >
avant votre texte :
> Ceci est une citation.
Pour un code en ligne
, entourez votre code avec des accents graves :
`le code va ici`
Pour des blocs de code sur plusieurs lignes, utilisez trois accents graves :
```md
\```
Ligne 1 du code
Ligne 2 du code
Ligne 3 du code
\```
Vous pouvez créer une ligne horizontale avec trois traits d’union, astérisques ou tirets bas :
---
| En-tête1 | En-tête2 |
|---------|---------|
| cellule1 | cellule2 |
| cellule3 | cellule4 |
- [x] Tâche terminée
- [ ] Tâche non terminée
Utilisez ~~
pour barrer le texte :
~~barré~~
Dans votre fichier Markdown, vous pouvez ajouter des citations en utilisant le symbole @
suivi de la clé de citation. Par exemple :
Selon des études récentes [@Smith2023], l'effet est...
Vous pouvez également utiliser plusieurs citations :
Certains chercheurs soutiennent ce point [@Smith2023; @Doe2022].
Les citations parenthétiques (ou intégrées au texte) placent l’auteur et l’année entre parenthèses :
Ce phénomène a été observé dans plusieurs contextes (par exemple, [@Smith2023]).
Les citations narratives intègrent l’auteur directement dans la phrase :
Selon @Smith2023, le phénomène...
Pour créer et gérer votre bibliographie, nous recommandons d’utiliser CiteDrive. CiteDrive est un gestionnaire de références natif BibTeX basé sur le cloud, conçu spécifiquement pour les utilisateurs d’Overleaf, LaTeX et R Markdown. Il simplifie le processus de conservation et d’exportation des citations au format .bib
.
Voici une entrée BibTeX que vous pourriez avoir dans votre fichier .bib
:
@article{Smith2023,
title = {Titre de l'étude},
author = {Smith, Jean},
year = 2023,
journal = {Nom du journal},
volume = 5,
pages = {10--20}
}