Différences entre les versions de « Markdown »
| Ligne 11 : | Ligne 11 : | ||
Pour créer des titres, on utilise le caractère # suivi d'un espace. | Pour créer des titres, on utilise le caractère # suivi d'un espace. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
# Titre niveau 1 | # Titre niveau 1 | ||
## Titre niveau 2 | ## Titre niveau 2 | ||
| Ligne 21 : | Ligne 21 : | ||
Pour créer un nouveau paragraphe, on le sépare du précédent par une ligne vide. | Pour créer un nouveau paragraphe, on le sépare du précédent par une ligne vide. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
Paragraphe 1 | Paragraphe 1 | ||
| Ligne 31 : | Ligne 31 : | ||
Pour forcer un retour à la ligne au sein d'un même paragraphe, on termine la ligne précédente par un espace. | Pour forcer un retour à la ligne au sein d'un même paragraphe, on termine la ligne précédente par un espace. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
Paragraphe 1. | Paragraphe 1. | ||
Suite du paragraphe 1 à la ligne. | Suite du paragraphe 1 à la ligne. | ||
| Ligne 38 : | Ligne 38 : | ||
Cependant cela peut être difficile à utiliser. On peut préférer l'utilisation de < br > comme en HTML. | Cependant cela peut être difficile à utiliser. On peut préférer l'utilisation de < br > comme en HTML. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
Paragraphe 1.<br> | Paragraphe 1.<br> | ||
Suite du paragraphe 1 à la ligne. | Suite du paragraphe 1 à la ligne. | ||
| Ligne 49 : | Ligne 49 : | ||
Pour afficher un texte en italique, on encadre ce texte par *. | Pour afficher un texte en italique, on encadre ce texte par *. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
*Texte en italique* | *Texte en italique* | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Ligne 57 : | Ligne 57 : | ||
Pour afficher un texte en gras, on encadre ce texte par **. | Pour afficher un texte en gras, on encadre ce texte par **. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
**Texte en gras** | **Texte en gras** | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Ligne 65 : | Ligne 65 : | ||
Pour afficher un texte en gras et en italique, on encadre ce texte par ***. | Pour afficher un texte en gras et en italique, on encadre ce texte par ***. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
***Texte en gras et en italique*** | ***Texte en gras et en italique*** | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Ligne 73 : | Ligne 73 : | ||
Pour afficher un paragraphe sous forme de citation, on précède chaque ligne (y compris les lignes vides) par le caractère > suivi d'un espace. | Pour afficher un paragraphe sous forme de citation, on précède chaque ligne (y compris les lignes vides) par le caractère > suivi d'un espace. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
> Tout obstacle renforce la détermination. | > Tout obstacle renforce la détermination. | ||
> Celui qui s'est fixé un but n'en change pas. | > Celui qui s'est fixé un but n'en change pas. | ||
| Ligne 86 : | Ligne 86 : | ||
Pour créer une liste ordonnée, on précède chaque ligne de 1. suivi d'un espace. | Pour créer une liste ordonnée, on précède chaque ligne de 1. suivi d'un espace. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
1. item 1 | 1. item 1 | ||
1. item 2 | 1. item 2 | ||
| Ligne 94 : | Ligne 94 : | ||
Une indentation imbrique une liste dans la liste. | Une indentation imbrique une liste dans la liste. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
1. item 1 | 1. item 1 | ||
1. item 2 | 1. item 2 | ||
| Ligne 106 : | Ligne 106 : | ||
Pour créer une liste non ordonnée, on précède chaque ligne de -, * ou + suivi d'un espace. | Pour créer une liste non ordonnée, on précède chaque ligne de -, * ou + suivi d'un espace. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
- item 1 | - item 1 | ||
- item 2 | - item 2 | ||
| Ligne 116 : | Ligne 116 : | ||
Pour spécifier une URL, on encadre le texte du lien avec [] et on le fait suivre de l'URL entre parenthèses. | Pour spécifier une URL, on encadre le texte du lien avec [] et on le fait suivre de l'URL entre parenthèses. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
[Geonov](https://www.geonov.fr/) | [Geonov](https://www.geonov.fr/) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Ligne 122 : | Ligne 122 : | ||
On peut également ajouter un titre au survol du lien. | On peut également ajouter un titre au survol du lien. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
[Geonov](https://www.geonov.fr/ "Le site de Geonov") | [Geonov](https://www.geonov.fr/ "Le site de Geonov") | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Ligne 130 : | Ligne 130 : | ||
Pour ajouter une image, on place le caractère ! suivi du texte alternatif entre [] puis du lien vers l'image entre () avec un titre au survol optionnel. | Pour ajouter une image, on place le caractère ! suivi du texte alternatif entre [] puis du lien vers l'image entre () avec un titre au survol optionnel. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
 |  | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Ligne 138 : | Ligne 138 : | ||
Pour citer du code, on l'encadre par le caractère `. | Pour citer du code, on l'encadre par le caractère `. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
Ci-joint mon `code`. | Ci-joint mon `code`. | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Ligne 144 : | Ligne 144 : | ||
Si le code lui-même contient le caractère `, on l'encadre par ``. | Si le code lui-même contient le caractère `, on l'encadre par ``. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
Ci-joint mon ``code ` code``. | Ci-joint mon ``code ` code``. | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Ligne 153 : | Ligne 153 : | ||
Cette ligne doit être précédée et suivie d'une ligne vide. | Cette ligne doit être précédée et suivie d'une ligne vide. | ||
<syntaxhighlight lang="" gutter="false" toolbar="false"> | <syntaxhighlight lang="text" gutter="false" toolbar="false"> | ||
Partie 1 | Partie 1 | ||
Version actuelle datée du 14 janvier 2021 à 21:58
Markdown est un langage informatique.
Il permet de rédiger des textes dans un simple éditeur à l'aide de balises légères qui ne rendent pas difficile la lecture d'un tel document.
Un fichier rédigé dans le langage Markdown peut être converti facilement en HTML, comme le fait le logiciel ghostwriter en temps réel.
1 Syntaxe
1.1 Titre
Pour créer des titres, on utilise le caractère # suivi d'un espace.
# Titre niveau 1
## Titre niveau 2
### Titre niveau 3
1.2 Paragraphe
Pour créer un nouveau paragraphe, on le sépare du précédent par une ligne vide.
Paragraphe 1
Paragraphe 2
1.3 Retour à la ligne
Pour forcer un retour à la ligne au sein d'un même paragraphe, on termine la ligne précédente par un espace.
Paragraphe 1.
Suite du paragraphe 1 à la ligne.
Cependant cela peut être difficile à utiliser. On peut préférer l'utilisation de < br > comme en HTML.
Paragraphe 1.<br>
Suite du paragraphe 1 à la ligne.
1.4 Formatage du texte
1.4.1 Italique
Pour afficher un texte en italique, on encadre ce texte par *.
*Texte en italique*
1.4.2 Gras
Pour afficher un texte en gras, on encadre ce texte par **.
**Texte en gras**
1.4.3 Gras et italique
Pour afficher un texte en gras et en italique, on encadre ce texte par ***.
***Texte en gras et en italique***
1.5 Citation
Pour afficher un paragraphe sous forme de citation, on précède chaque ligne (y compris les lignes vides) par le caractère > suivi d'un espace.
> Tout obstacle renforce la détermination.
> Celui qui s'est fixé un but n'en change pas.
Il est possible d'imbriquer une citation dans une autre en doublant le caractère >.
1.6 Liste
1.6.1 Liste ordonnée
Pour créer une liste ordonnée, on précède chaque ligne de 1. suivi d'un espace.
1. item 1
1. item 2
1. item 3
Une indentation imbrique une liste dans la liste.
1. item 1
1. item 2
1. sous-item 1
1. sous-item 2
1. item 3
1.6.2 Liste non ordonnée
Pour créer une liste non ordonnée, on précède chaque ligne de -, * ou + suivi d'un espace.
- item 1
- item 2
- item 3
1.7 URL
Pour spécifier une URL, on encadre le texte du lien avec [] et on le fait suivre de l'URL entre parenthèses.
[Geonov](https://www.geonov.fr/)
On peut également ajouter un titre au survol du lien.
[Geonov](https://www.geonov.fr/ "Le site de Geonov")
1.8 Image
Pour ajouter une image, on place le caractère ! suivi du texte alternatif entre [] puis du lien vers l'image entre () avec un titre au survol optionnel.
1.9 Code
Pour citer du code, on l'encadre par le caractère `.
Ci-joint mon `code`.
Si le code lui-même contient le caractère `, on l'encadre par ``.
Ci-joint mon ``code ` code``.
1.10 Ligne horizontale
Pour créer une ligne horizontale, on crée une nouvelle ligne avec ***, --- ou ___. Cette ligne doit être précédée et suivie d'une ligne vide.
Partie 1
***
Partie 2
Vous trouverez ces informations et d'autres (syntaxe étendue) sur le site officiel : https://www.markdownguide.org/basic-syntax/