Bases Markdown

Michel Billaud (michel.billaud@laposte.net)

13 juin 2020

Ce texte fait partie d’une petite collection de notes mise à disposition selon les termes de la Licence Creative Commons Attribution - Pas d’Utilisation Commerciale - Partage dans les Mêmes Conditions 2.0 France.

Dernière révision 3 nov 2021

1 Structure d’un document

Un document Markdown commence par une entête de 3 lignes, suivie par un texte structuré.

1.1 Entête du document

Les lignes de l’entête commencent par le caractère “pourcent”, et donnent - dans cet ordre - le titre, l’auteur et la date.

Exemple

% Exercices de programmation
% Alan Smithee
% 1er Avril 2021

1.2 Titraille

Les lignes de titres commencent par des dièses #, dont le nombre indique le niveau.

Exemple :

# Structure d'un document

Un document Markdown commence par une entête de 3 lignes, 
suivie par un texte structuré.

## Entête du document

Les lignes de l'entête commencent par le caractère "pourcent", et 
donnent le titre, l'auteur et la date.

**Exemple**
....

2 Décoration des caractères

Si on tape :

Les textes "décorés" sont entourés

- par des étoiles pour les *italiques*,
- par des étoiles pour les **caractères gras**,
- par des "backquotes" pour du `code informatique`.

On voit :

Les textes “décorés” sont entourés

Remarque: pour afficher ces caractères spéciaux tels-quels, les précéder d’un antislash \.

3 Listes

3.1 Listes à puces

Chaque élément commence par un tiret. Les sous-listes sont décalées vers la droite.

- France
   - Vin
   - Fromage
- Italie
   - Pizza
   - Scooter

Apparence :

3.2 Listes numérotées

1. FORTRAN
2. LISP
3. COBOL

Apparence :

  1. FORTRAN
  2. LISP
  3. COBOL

4 Blocs de code

Un bloc de code est encadré par des lignes “~~~”. Le nom du langage permet la colorisation des mots-clés.

Par exemple :

~~~java
int en_couleur () {
   return 1;
}
~~~

apparaît sous la forme :

int en_couleur () {
   return 1;
}

Remarque. On peut aussi utiliser la marque “```”, le bloc pourra alors contenir l’autre marque.

5 Liens hypertexte, pour en savoir plus.

Lisez la [documentation](https://pandoc.org/MANUAL.html)

Lisez la documentation