Syntaxe du langage Markdown - Mémento
Intérêt de ce langage
Citons quelques éléments glanés de part et d'autre:
- Format natif simple => un smple éditeur de textes suffit pour ouvrir un tel fichier.
- S'affranchir des formats propriétaires (MS WORD).
- Syntaxe très simple.
- Suffit aus besoins de base de manipulation de textes dans 90% des cas.
- Gestion des caractères spéciaux (équations par exemple).
- Texte avec syntaxe Markdown reste très facile à lire.
- Des outils por la saisie et la visualisation sont proposés en fin de page.
Paragraphes
Ceci est un paragraphe.
Il faut sauter une ligne pour créer un nouveau paragraphe.
Voici un nouveau paragraphe.
Ceci est un paragraphe. Il faut sauter une ligne pour créer un nouveau paragraphe.
Voici un nouveau paragraphe
Titres
De niveau 1 à 6 comme en HTML
# Titre 1
## Titre 2
### Titre 3
#### Titre 4
##### Titre 5
###### Titre 6
Ce qui donne pour les 4 derniers :
Titre 3
Titre 4
Titre 5
Titre 6
Autre moyen
Titre 1
=======
Titre 2
-------
D'où:
Titre 1
Titre 2
Enrichissement du texte
Gras
**Ceci est en gras**
Ce qui donne:
Ceci est gras.
Italique
_Ceci est en italique_
Ce qui donne:
Ceci est en italique
Donc
__*Gras et italique*__
Gras et italique
Listes
Avec puces
- Point 1
- Point 2
+ Point 3
- Point trois un (Tabulation)
- Point trois deux
d'où:
- Point 1
- Point 2
Point 3
- Point trois un
- Point trois deux
Numérotées
1. Introduction
2. Partie 1
3. Partie 2
1. Partie 1 chapitre 1 (Tabulation)
2. Partie 2 chapitre 2
4. Conclusion
Introduction
Partie 1
Partie 2
- Partie 2 Chapitre 1
- Partie 2 chapitre 2
Conclusion
Citation
> Une gare, c’est un lieu où on croise les gens qui réussissent et les gens qui ne sont rien
> Il faut des jeunes Français qui aient envie de devenir milliardaires
> Je n’aime pas ce terme de modèle social.
> Être élu est un cursus d’un ancien temps
Une gare, c’est un lieu où on croise les gens qui réussissent et les gens qui ne sont rien
Il faut des jeunes Français qui aient envie de devenir milliardaires.
Je n’aime pas ce terme de modèle social.
Être élu est un cursus d’un ancien temps
Vous constatez que cela marche très bien, même avec des citations totalement ridicules.
Code source (Ici php)
<code>
<?php
$variable=15;
echo $variable;
?>
</code>
<?php
$variable=15; echo $variable;
?>
La coloration du code s'obtient avec ```php au début
et ``` à la fin.
<?php
$mavariable_1 = 5;
$mavariable_2 = 3;
$var_total = $mavariable_1 + $mavariable_2;
echo $total;
?>
Lien hypertexte
[Très bon site](http://aristeri.com)
Images
Insérons une image qui se trouve sur aristeri.com:
barre horizontale de séparation
---
Tableaux
| Entete 1| En tête 2| Entête 3|
|:--------|:--------:|--------:|
|Voici un| Très| Joli tableau|
|5,28|23325,75|2.14|
| Entete 1 | En tête 2 | Entête 3 |
|---|---|---|
| Voici un | Très | Joli tableau |
| 5,28 | 23325,75 | 2.14 |
L'entête 1 et la 1ère colonne sont alignés à gauche (:---). La seconde colonne contient des éléments centrés (:---:) et la dernière comprends des données alignées à droite (-----:)
Equations mathématiques
Mardown ne comprend pas cela en natif mais accepte la synxaxe LATEX.
$$
f(x)=ax²+bx+c
$$
$$
\frac {\sum {n_ix_i}}{N_i}
$$
Outils pour la saisie et la visualisation du Markdown:
Un fichier Mardown étant un simple fichier texte tout éditeur de textes convient. Toutefois la coloration syntaxique offre une convivialité et un confort bien appréciable en séparant visuellement la syntaxe du contenu; exemple avec l'éditeur VSCode:
Editeurs en ligne
Solution pratique pour une utilisation occasionnelle comme rédiger un prompt pour une IA.
- Cet éditeur, VSCode, est aussi disponible en ligne!
- Convertir, Saisir, Visualiser, récupérer: Convertisseur en ligne de bien pensé, simple et très utile. Conseils Rédaction Web
- L'éditeur en ligne Dillinger qui permet saisie, visualisation, rendu, et sauvegarde. Interface en angalis avec un rappel des bases de la syntaxe
- Editeur Markdown propose une assistance à la saisie et la visualisation du rendu + la sauvegarde. En français!
- Enfin MarkMath permet la saisie, la visualisationru rendu, l'apprentissange et la récupération du fichier. Idéal pour débuter.
- .... et il y en a beaucoup d'autres certainement excellents aussi.
Editeurs Markdown
Intéressant d'en avoir un installé sur son ordinateur pour une utilisation régulière et si on veut se dispenser de la saisie de la syntaxe.
- Typora l'un des plus conviviaux et des plus utilisés. Très beau rendu. Idéal por les néophytes.
- Marka libre, gratuit et en open source se montre léger et très agréable à utiliser
- ... et beaucoup d'autres excellents!
💻