Différences entre les versions de « Markdown »

De Wiki de Geonov
(Page créée avec « 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… »)
 
Ligne 4 : Ligne 4 :


Un fichier rédigé dans le langage [[Markdown]] peut être converti facilement en [[HTML]], comme le fait le logiciel [[ghostwriter]] en temps réel.
Un fichier rédigé dans le langage [[Markdown]] peut être converti facilement en [[HTML]], comme le fait le logiciel [[ghostwriter]] en temps réel.
= Syntaxe =
== Titre ==
Pour créer des titres, on utilise le caractère # suivi d'un espace.
<syntaxhighlight lang="" gutter="false" toolbar="false">
# Titre niveau 1
## Titre niveau 2
### Titre niveau 3
</syntaxhighlight>
== Paragraphe ==
Pour créer un nouveau paragraphe, on le sépare du précédent par une ligne vide.
<syntaxhighlight lang="" gutter="false" toolbar="false">
Paragraphe 1
Paragraphe 2
</syntaxhighlight>
== 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.
<syntaxhighlight lang="" gutter="false" toolbar="false">
Paragraphe 1.
Suite du paragraphe 1 à la ligne.
</syntaxhighlight>
Cependant cela peut être difficile à utiliser. On peut préférer l'utilisation de < br > comme en HTML.
<syntaxhighlight lang="" gutter="false" toolbar="false">
Paragraphe 1.<br>
Suite du paragraphe 1 à la ligne.
</syntaxhighlight>
== Formatage du texte ==
=== Italique ===
Pour afficher un texte en italique, on encadre ce texte par *.
<syntaxhighlight lang="" gutter="false" toolbar="false">
*Texte en italique*
</syntaxhighlight>
=== Gras ===
Pour afficher un texte en gras, on encadre ce texte par **.
<syntaxhighlight lang="" gutter="false" toolbar="false">
**Texte en gras**
</syntaxhighlight>
=== Gras et italique ===
Pour afficher un texte en gras et en italique, on encadre ce texte par ***.
<syntaxhighlight lang="" gutter="false" toolbar="false">
***Texte en gras et en italique***
</syntaxhighlight>
== 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.
<syntaxhighlight lang="" gutter="false" toolbar="false">
> Tout obstacle renforce la détermination.
> Celui qui s'est fixé un but n'en change pas.
</syntaxhighlight>
Il est possible d'imbriquer une citation dans une autre en doublant le caractère >.
== Liste ==
=== Liste ordonnée ===
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">
1. item 1
1. item 2
1. item 3
</syntaxhighlight>
Une indentation imbrique une liste dans la liste.
<syntaxhighlight lang="" gutter="false" toolbar="false">
1. item 1
1. item 2
    1. sous-item 1
    1. sous-item 2
1. item 3
</syntaxhighlight>
=== Liste non ordonnée ===
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">
- item 1
- item 2
- item 3
</syntaxhighlight>
== URL ==
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">
[Geonov](https://www.geonov.fr/)
</syntaxhighlight>
On peut également ajouter un titre au survol du lien.
<syntaxhighlight lang="" gutter="false" toolbar="false">
[Geonov](https://www.geonov.fr/ "Le site de Geonov")
</syntaxhighlight>
== 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.
<syntaxhighlight lang="" gutter="false" toolbar="false">
![Logo de Geonov](/image/logo.png "Le logo de Geonov")
</syntaxhighlight>
== Code ==
Pour citer du code, on l'encadre par le caractère `.
<syntaxhighlight lang="" gutter="false" toolbar="false">
Ci-joint mon `code`.
</syntaxhighlight>
Si le code lui-même contient le caractère `, on l'encadre par ``.
<syntaxhighlight lang="" gutter="false" toolbar="false">
Ci-joint mon ``code ` code``.
</syntaxhighlight>
== 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.
<syntaxhighlight lang="" gutter="false" toolbar="false">
Partie 1
***
Partie 2
</syntaxhighlight>
Vous trouverez ces informations et d'autres (syntaxe étendue) sur le site officiel : https://www.markdownguide.org/basic-syntax/


[[Catégorie:Langage]]
[[Catégorie:Langage]]

Version du 12 janvier 2021 à 11:56

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.

![Logo de Geonov](/image/logo.png "Le logo de Geonov")

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/