- Améliore l'exemple de syntaxe Markdown avec des retours à la ligne et
une section sur les titres.
- Supprime les codeblocks qui prêtent à confusion.
- Ignore le rendu HTML généré par pandoc, qui est peut-être une
meilleure représentation que la prévisualisation dynamique depuis
neovim.
Co-Authored-by: iGor milhit <igor@milhit.ch>
Pour écrire un paragraphe, il faut séparer deux blocs de texte par une ligne vide. Un simple retour à la ligne
Pour écrire un paragraphe, il faut séparer deux blocs de texte par une ligne
vide. Un simple retour à la ligne
ne change rien.
ne change rien.
Ici commence le paragraphe suivant. Dans celui-ci, on peut insérer *un texte en italique*, soit en entourant la partie en *italique* par des astérisques (`*`), soit au moyen _d'underscore_ (`_`).
Ici commence le paragraphe suivant. Dans celui-ci, on peut insérer *un texte en
italique*, soit en entourant la partie en *italique* par des astérisques (`*`),
soit au moyen _d'underscore_ (`_`).
Pour le gras, **on utilise un double astérisque**, ou __un double underscore__.
Pour le gras, **on utilise un double astérisque**, ou __un double underscore__.
## Les titres
Comme en HTML, il y a 6 niveaux de titres disponibles. Pour indiquer qu'il
s'agit d'un titre, il faut commencer la ligne par un `#`, et on multiplie les
`#` pour indiquer les niveaux de titre de 1 (`#`) à 6 (`######`). Ce fichier
d'exemple contient un titre de niveau 1 et des titres de niveau 2 et 3.
## Les listes
## Les listes
Pour générer une liste, on commence chaque ligne de la liste avec un tiret:
Pour générer une liste, on commence chaque ligne de la liste avec un tiret:
```markdown
- Une liste
- Simple et
- Non ordonnée.
```
- Une liste
- Une liste
- Simple et
- Simple et
- Non ordonnée.
- Non ordonnée.
Pour une liste ordonnée, on commence chaque ligne par un chiffre suivit d'un point:
Pour une liste ordonnée, on commence chaque ligne par un chiffre suivit d'un
point:
```markdown
1. Une liste
3. Simple mais
9. Ordonnée.
```
1. Une liste
1. Une liste
3. Simple mais
3. Simple mais
9. Ordonnée.
9. Ordonnée.
L'ordre de la numérotation n'importe pas. Pour ne pas s'ennuyer à réordonner une liste qui peut évoluer, il y a une solution simple:
L'ordre de la numérotation n'importe pas. Pour ne pas s'ennuyer à réordonner
une liste qui peut évoluer, il y a une solution simple:
```markdown
1. Pomme.
1. Poire.
1. Cerise.
```
1. Pomme.
1. Pomme.
1. Poire.
1. Poire.
1. Cerise.
1. Cerise.
Des listes imbriquées plus complexes peuvent être réalisées en ajoutant des espaces devant les lignes des sections inférieures:
Des listes imbriquées plus complexes peuvent être réalisées en ajoutant des
espaces devant les lignes des sections inférieures:
```markdown
1. Une liste
1. Ordonnée et
- Plus
- Complexe
1. Voilà.
```
1. Une liste
1. Une liste
1. Ordonnée et
1. Ordonnée et
@ -65,51 +52,52 @@ Des listes imbriquées plus complexes peuvent être réalisées en ajoutant des
### La méthode simple
### La méthode simple
Il y a plusieurs méthodes pour insérer un lien. La plus simple est de mettre le texte du lien entre crochets, suivi de la cible entre parenthèses:
Il y a plusieurs méthodes pour insérer un lien. La plus simple est de mettre le
texte du lien entre crochets, suivi de la cible entre parenthèses:
[site de l'UNIGE](https://unige.ch).
```markdown
On peut vouloir ajouter un titre à ce lien, qui s'affiche lorsque le curseur
[site de l'UNIGE](https://unige.ch)
survol le lien: [site de l'UNIGE](https://unige.ch "site officiel d'UNIGE").
```
Ce qui donne le lien suivant: [site de l'UNIGE](https://unige.ch).
On peut vouloir ajouter un titre à ce lien, qui s'affiche lorsque le curseur survol le lien:
```markdown
[site de l'UNIGE](https://unige.ch "site officiel d'UNIGE")
```
Ce qui donne le lien suivant:
[site de l'UNIGE](https://unige.ch "site officiel d'UNIGE").
### Avec les références
### Avec les références
Une autre méthode existe qui a les avantages suivants:
Une autre méthode existe qui a les avantages suivants:
- Une même référence (cible du lien) peut être réutilisée plusieurs fois dans le même texte.
- Une même référence (cible du lien) peut être réutilisée plusieurs fois dans
le même texte.
- La lisibilité du texte est améliorée.
- La lisibilité du texte est améliorée.
Le texte du lien est toujours entre crochet, mais à la place de la cible entre parenthèse, on ajoute une référence entre crochet. Cette référence, qui peut être un chiffre, une lettre ou un texte, correspond à la cible, définie n'importe où dans le fichier.
Le texte du lien est toujours entre crochet, mais à la place de la cible entre
parenthèse, on ajoute une référence entre crochet. Cette référence, qui peut
```markdown
être un chiffre, une lettre ou un texte, correspond à la cible, définie
[site de l'UNIGE][1]
n'importe où dans le fichier.
[1]: https://unige.ch "site officiel de l'UNIGE"
```
Ce qui donne le lien suivant: [site de l'UNIGE][1].
Ce qui donne le lien suivant: [site de l'UNIGE][1].
## Images (fichiers)
## Images
Pour l'insertion d'une image, on reprend la même syntaxe que pour le lien, en ajoutant un point d'exclamation au début de la ligne:
Pour l'insertion d'une image, on reprend la même syntaxe que pour le lien, en
ajoutant un point d'exclamation au début de la ligne:
Le lien pour l'image peut être une URL ou un chemin vers un fichier local. Et la syntaxe avec la référence est possible aussi:
Le lien pour l'image peut être une URL ou un chemin vers un fichier local. Et
la syntaxe avec la référence est possible aussi:
![Légende de l'image][2]
![Légende de l'image][2]
## Les tableaux
Pour les tableaux, il est fortement conseillé d'utiliser un [générateur][3].
{"id":"commonmarkCommonMarkStronglyDefined","accessed":{"date-parts":[["2023",4,25]]},"author":[{"family":"CommonMark","given":""}],"citation-key":"commonmarkCommonMarkStronglyDefined","container-title":"CommonMark","language":"eng","title":"CommonMark: A strongly defined, highly compatible specification of Markdown","type":"webpage","URL":"https://commonmark.org/"},
{"id":"eyssetteUtiliserMarkdownPour2023","accessed":{"date-parts":[["2023",4,17]]},"author":[{"family":"Eyssette","given":"Cédric"}],"citation-key":"eyssetteUtiliserMarkdownPour2023","issued":{"date-parts":[["2023"]]},"language":"fre","title":"Utiliser le markdown pour tout faire","type":"speech","URL":"https://eyssette.forge.aeif.fr/marp-slides/slides/2022-2023/utiliser-le-markdown-pour-tout-faire"},
{"id":"eyssetteUtiliserMarkdownPour2023","accessed":{"date-parts":[["2023",4,17]]},"author":[{"family":"Eyssette","given":"Cédric"}],"citation-key":"eyssetteUtiliserMarkdownPour2023","issued":{"date-parts":[["2023"]]},"language":"fre","title":"Utiliser le markdown pour tout faire","type":"speech","URL":"https://eyssette.forge.aeif.fr/marp-slides/slides/2022-2023/utiliser-le-markdown-pour-tout-faire"},
{"id":"fressinaudGuideMarkdown2022","abstract":"Un guide simple pour apprendre Markdown.","accessed":{"date-parts":[["2023",4,17]]},"author":[{"family":"Fressinaud","given":"Marien"}],"citation-key":"fressinaudGuideMarkdown2022","container-title":"flus","genre":"Site d'une application web","issued":{"date-parts":[["2022",7,11]]},"language":"fre","title":"Guide Markdown","type":"webpage","URL":"https://flus.fr/carnet/markdown.html"},
{"id":"fressinaudGuideMarkdown2022","abstract":"Un guide simple pour apprendre Markdown.","accessed":{"date-parts":[["2023",4,17]]},"author":[{"family":"Fressinaud","given":"Marien"}],"citation-key":"fressinaudGuideMarkdown2022","container-title":"flus","genre":"Site d'une application web","issued":{"date-parts":[["2022",7,11]]},"language":"fre","title":"Guide Markdown","type":"webpage","URL":"https://flus.fr/carnet/markdown.html"},
{"id":"gruberDiveMarkdown2004","accessed":{"date-parts":[["2025",8,22]]},"author":[{"family":"Gruber","given":"John"}],"citation-key":"gruberDiveMarkdown2004","container-title":"Daring Fireball","issued":{"date-parts":[["2004",3,19]]},"language":"eng","title":"Dive into markdown","type":"post-weblog","URL":"https://daringfireball.net/2004/03/dive_into_markdown"},
{"id":"martinolliManuelPratiqueRecherche2024","abstract":"Ce manuel est principalement conçu pour accompagner le séminaire PLU6058, qui vise à améliorer les compétences informationnelles des étudiant.es des cycles supérieurs de l’Université de Montréal. Cependant, il peut également être utilisé de manière autonome et autodidacte pour la recherche et l’utilisation de la documentation dans le cadre d’un projet de recherche. En outre, il peut être utilisé comme une ressource éducative par les enseignant.es en bibliothèque de recherche.","accessed":{"date-parts":[["2024",11,12]]},"author":[{"family":"Martinolli","given":"Pascal"}],"citation-key":"martinolliManuelPratiqueRecherche2024","issued":{"date-parts":[["2024",11,8]]},"language":"fre","note":"https://github.com/pmartinolli/QMpRD","title":"Manuel pratique de recherche documentaire","type":"document","URL":"https://pmartinolli.github.io/QMpRD/"},
{"id":"martinolliManuelPratiqueRecherche2024","abstract":"Ce manuel est principalement conçu pour accompagner le séminaire PLU6058, qui vise à améliorer les compétences informationnelles des étudiant.es des cycles supérieurs de l’Université de Montréal. Cependant, il peut également être utilisé de manière autonome et autodidacte pour la recherche et l’utilisation de la documentation dans le cadre d’un projet de recherche. En outre, il peut être utilisé comme une ressource éducative par les enseignant.es en bibliothèque de recherche.","accessed":{"date-parts":[["2024",11,12]]},"author":[{"family":"Martinolli","given":"Pascal"}],"citation-key":"martinolliManuelPratiqueRecherche2024","issued":{"date-parts":[["2024",11,8]]},"language":"fre","note":"https://github.com/pmartinolli/QMpRD","title":"Manuel pratique de recherche documentaire","type":"document","URL":"https://pmartinolli.github.io/QMpRD/"},
{"id":"masuttiRedigerManipulerDocuments2019","accessed":{"date-parts":[["2024",3,19]]},"author":[{"family":"Masutti","given":"Christophe"}],"citation-key":"masuttiRedigerManipulerDocuments2019","container-title":"Statium : blog","issued":{"date-parts":[["2019",5,8]]},"language":"fre","title":"Rédiger et manipuler des documents avec Markdown","type":"post-weblog","URL":"https://golb.statium.link/post/20190528rediger-et-manipuler-des-documents-markdown/"},
{"id":"masuttiRedigerManipulerDocuments2019","accessed":{"date-parts":[["2024",3,19]]},"author":[{"family":"Masutti","given":"Christophe"}],"citation-key":"masuttiRedigerManipulerDocuments2019","container-title":"Statium : blog","issued":{"date-parts":[["2019",5,8]]},"language":"fre","title":"Rédiger et manipuler des documents avec Markdown","type":"post-weblog","URL":"https://golb.statium.link/post/20190528rediger-et-manipuler-des-documents-markdown/"},
{"id":"ovadiaMarkdownLibrariansAcademics2014","accessed":{"date-parts":[["2023",5,2]]},"author":[{"family":"Ovadia","given":"Steven"}],"citation-key":"ovadiaMarkdownLibrariansAcademics2014","container-title":"Behavioral & Social Sciences Librarian","container-title-short":"Behavioral & Social Sciences Librarian","DOI":"10.1080/01639269.2014.904696","ISSN":"0163-9269, 1544-4546","issue":"2","issued":{"date-parts":[["2014"]]},"language":"en","page":"120-124","source":"DOI.org (Crossref)","title":"Markdown for Librarians and Academics","type":"article-journal","URL":"http://www.tandfonline.com/doi/abs/10.1080/01639269.2014.904696","volume":"33"},
{"id":"ovadiaMarkdownLibrariansAcademics2014","accessed":{"date-parts":[["2023",5,2]]},"author":[{"family":"Ovadia","given":"Steven"}],"citation-key":"ovadiaMarkdownLibrariansAcademics2014","container-title":"Behavioral & Social Sciences Librarian","container-title-short":"Behavioral & Social Sciences Librarian","DOI":"10.1080/01639269.2014.904696","ISSN":"0163-9269, 1544-4546","issue":"2","issued":{"date-parts":[["2014"]]},"language":"en","page":"120-124","source":"DOI.org (Crossref)","title":"Markdown for Librarians and Academics","type":"article-journal","URL":"http://www.tandfonline.com/doi/abs/10.1080/01639269.2014.904696","volume":"33"},
{"id":"perretFormatTexte2022","abstract":"Cette page explique ce qu’est le format texte et donne des arguments en faveur de son utilisation. Elle ouvre vers d’autres ressources pour explorer l’écosystème du format texte.","accessed":{"date-parts":[["2023",4,18]]},"author":[{"family":"Perret","given":"Arthur"}],"citation-key":"perretFormatTexte2022","container-title":"Arthur Perret","issued":{"date-parts":[["2022",12,11]]},"language":"fre","title":"Format texte","type":"article-journal","URL":"https://www.arthurperret.fr/cours/format-texte.html"},
{"id":"perretFormatTexte2022","abstract":"Cette page explique ce qu’est le format texte et donne des arguments en faveur de son utilisation. Elle ouvre vers d’autres ressources pour explorer l’écosystème du format texte.","accessed":{"date-parts":[["2023",4,18]]},"author":[{"family":"Perret","given":"Arthur"}],"citation-key":"perretFormatTexte2022","container-title":"Arthur Perret","issued":{"date-parts":[["2022"]]},"language":"fre","title":"Format texte","type":"article-journal","URL":"https://www.arthurperret.fr/cours/format-texte.html"},
{"id":"perretMarkdown2022","abstract":"Cette page explique ce qu’est Markdown, le plus populaire des langages de balisage léger, et renvoie vers un tutoriel interactif en français.","accessed":{"date-parts":[["2023",4,17]]},"author":[{"family":"Perret","given":"Arthur"}],"citation-key":"perretMarkdown2022","container-title":"Arthur Perret","issued":{"date-parts":[["2022",12,11]]},"language":"fr","publisher":"arthurperret.fr/","title":"Markdown","type":"article-journal","URL":"https://www.arthurperret.fr/cours/markdown.html"},
{"id":"perretMarkdown2022","abstract":"Cette page explique ce qu’est Markdown, le plus populaire des langages de balisage léger, et renvoie vers un tutoriel interactif en français.","accessed":{"date-parts":[["2023",4,17]]},"author":[{"family":"Perret","given":"Arthur"}],"citation-key":"perretMarkdown2022","container-title":"Arthur Perret","issued":{"date-parts":[["2022",12,11]]},"language":"fr","publisher":"arthurperret.fr/","title":"Markdown","type":"article-journal","URL":"https://www.arthurperret.fr/cours/markdown.html"},
{"id":"perretMarkdownTraitementTexte2022","accessed":{"date-parts":[["2024",4,23]]},"author":[{"family":"Perret","given":"Arthur"}],"citation-key":"perretMarkdownTraitementTexte2022","container-title":"arthurperret.fr","issued":{"date-parts":[["2022",10,25]]},"language":"fre","title":"Markdown et traitement de texte: une méthode pour collaborer","title-short":"Markdown et traitement de texte","type":"post-weblog","URL":"https://www.arthurperret.fr/blog/2022-10-25-markdown-traitement-de-texte-methode-pour-collaborer.html"},
{"id":"perretMarkdownTraitementTexte2022","accessed":{"date-parts":[["2024",4,23]]},"author":[{"family":"Perret","given":"Arthur"}],"citation-key":"perretMarkdownTraitementTexte2022","container-title":"arthurperret.fr","issued":{"date-parts":[["2022",10,25]]},"language":"fre","title":"Markdown et traitement de texte: une méthode pour collaborer","title-short":"Markdown et traitement de texte","type":"post-weblog","URL":"https://www.arthurperret.fr/blog/2022-10-25-markdown-traitement-de-texte-methode-pour-collaborer.html"},
{"id":"pollardTemplateWritingPhD2023","abstract":"Template for writing a PhD thesis in Markdown","accessed":{"date-parts":[["2023",4,17]]},"author":[{"family":"Pollard","given":"Tom"}],"citation-key":"pollardTemplateWritingPhD2023","genre":"HTML","issued":{"date-parts":[["2023",4,17]]},"license":"MIT","original-date":{"date-parts":[["2015",2,10]]},"source":"GitHub","title":"Template for writing a PhD thesis in Markdown","type":"software","URL":"https://github.com/tompollard/phd_thesis_markdown"}
{"id":"pollardTemplateWritingPhD2023","abstract":"Template for writing a PhD thesis in Markdown","accessed":{"date-parts":[["2023",4,17]]},"author":[{"family":"Pollard","given":"Tom"}],"citation-key":"pollardTemplateWritingPhD2023","genre":"HTML","issued":{"date-parts":[["2023",4,17]]},"license":"MIT","original-date":{"date-parts":[["2015",2,10]]},"source":"GitHub","title":"Template for writing a PhD thesis in Markdown","type":"software","URL":"https://github.com/tompollard/phd_thesis_markdown"},
{"id":"swartzMarkdown2004","accessed":{"date-parts":[["2025",8,26]]},"author":[{"family":"Swartz","given":"Aaron"}],"citation-key":"swartzMarkdown2004","container-title":"Aaron Swartz's Raw Thoughts","issued":{"date-parts":[["2004",3,19]]},"language":"eng","title":"Markdown","type":"post-weblog","URL":"http://www.aaronsw.com/weblog/001189"},
{"id":"wikipediaFichierTexte2025","abstract":"En informatique, un fichier texte ou fichier texte brut ou fichier texte simple[réf. nécessaire] est un fichier dont le contenu représente uniquement une suite de caractères ; il utilise nécessairement une forme particulière de codage des caractères qui peut être une variante ou une extension du standard local des États-Unis, l'ASCII. Il n'existe aucune définition officielle, et les différentes interprétations de ce qu'est un fichier texte partagent des propriétés essentielles. Les caractères considérés sont généralement les caractères imprimables, d'espaces et de retours à la ligne. Certains codages de caractères normalisés incluent également certains caractères de contrôle, séquence d'échappement ou marqueurs qui peuvent faire l'objet de différences d'appréciations. La notion de fichier texte est donc subjective et dépend notamment des systèmes de codage de caractère considérés (windows-1252 et ISO-8859-1 n'offrant pas les mêmes plages de valeurs «imprimables».)\nUn fichier « non texte » est appelé « fichier binaire », dans le sens où les bits contenus dans le fichier ne représentent pas une simple suite de caractères imprimables, d'espaces et de retours à la ligne.","accessed":{"date-parts":[["2025",6,12]]},"author":[{"family":"Wikipédia","given":""}],"citation-key":"wikipediaFichierTexte2025","container-title":"Wikipédia","issued":{"date-parts":[["2025",1,23]]},"language":"fr","license":"Creative Commons Attribution-ShareAlike License","note":"Page Version ID: 222327630","source":"Wikipedia","title":"Fichier texte","type":"entry-encyclopedia","URL":"https://fr.wikipedia.org/w/index.php?title=Fichier_texte&oldid=222327630"},
{"id":"wikipediaLangageBalisageLeger2024","abstract":"Un langage de balisage léger est un type de langage de balisage utilisant une syntaxe simple, conçu pour être facile à saisir avec un simple éditeur de texte, et facile à lire dans sa forme non formatée.","accessed":{"date-parts":[["2025",8,21]]},"author":[{"family":"Wikipédia","given":""}],"citation-key":"wikipediaLangageBalisageLeger2024","container-title":"Wikipédia","issued":{"date-parts":[["2024",5,31]]},"language":"fr","license":"Creative Commons Attribution-ShareAlike License","note":"Page Version ID: 215543860","source":"Wikipedia","title":"Langage de balisage léger","type":"entry-encyclopedia","URL":"https://fr.wikipedia.org/w/index.php?title=Langage_de_balisage_l%C3%A9ger&oldid=215543860"},
{"id":"wikipediaMarkdown2025","abstract":"Markdown est un langage de balisage léger créé en 2004 par John Gruber, avec l'aide d'Aaron Swartz,, avec l'objectif d'offrir une syntaxe, facile à lire et à écrire, en l'état, sans formatage.\nMarkdown est principalement utilisé dans des blogs, des sites de messagerie instantanée, des forums et des pages de documentation de logiciels. Depuis quelques années, Markdown est utilisé par la communauté scientifique,,, en lien avec la Science ouverte.\nUn document balisé par Markdown peut être converti en HTML, en PDF ou en d'autres formats. Bien que la syntaxe Markdown ait été influencée par plusieurs filtres de conversion de texte existants vers HTML — dont Setext, atx, Textile, reStructuredText, Grutatext et EtText —, la source d’inspiration principale du Markdown est le format du courrier électronique en mode texte.","accessed":{"date-parts":[["2025",6,11]]},"author":[{"family":"Wikipédia","given":""}],"citation-key":"wikipediaMarkdown2025","container-title":"Wikipédia","issued":{"date-parts":[["2025",6,6]]},"language":"fr","license":"Creative Commons Attribution-ShareAlike License","note":"Page Version ID: 226296660","source":"Wikipedia","title":"Markdown","type":"entry-encyclopedia","URL":"https://fr.wikipedia.org/w/index.php?title=Markdown&oldid=226296660"}
iGor milhit