Premiers pas⚓︎
Comme bon exercice, pour débuter, on recommande de choisir une page web simple que l'on souhaite recréer. On ne cherchera pas à recréer les effets de couleurs ou de disposition.
Premiers objectifs :
- Structurer la page
- Savoir créer des paragraphes
- Savoir créer des listes à puces et des listes numérotées
- Savoir insérer des liens ou des images
- Mettre quelques rares mots en relief
- Savoir faire un tableau
Structurer son document⚓︎
Le premier conseil à suivre et le plus important, est de structurer le document que l'on veut produire.
On utilise pour cela des sections, des sous-sections, chacune avec un titre et des paragraphes.
Voici un exemple de structure
# Titre du document
paragraphe d'intro
## Titre du I]
### Titre du I.a)
paragraphe_1
paragraphe_2
### Titre du I.b)
paragraphes
## Titre du II]
...
Astuces
Il sera inutile de créer manuellement le sommaire de la page que vous recréez. Il sera possible de créer le sommaire automatiquement.
Ne créez pas le sommaire manuellement
Créer des paragraphes⚓︎
Après le titre, on saute une ligne.
Il suffit ensuite d'écrire son texte, en début de ligne. On peut sauter à la ligne, ce sera considérer comme une espace ; le texte prendra la place disponible à l'écran de l'utilisateur.
Pour faire un nouveau paragraphe, on laisse une ligne vide entre deux paragraphes. C'est naturel.
Créer des listes à puces⚓︎
On suit le modèle
À écrire
Mon programme :
- faire des titres de niveaux 1 à 6 avec #
- faire des listes à puces
- faire des listes numérotées
- insérer des liens et des images
- ajouter un peu d'emphase
- créer des tableaux
Résultat
Mon programme :
- faire des titres de niveaux 1 à 6 avec #
- faire des listes à puces
- faire des listes numérotées
- insérer des liens et des images
- ajouter un peu d'emphase
- créer des tableaux
Créer une liste numérotée⚓︎
On suit le modèle
À écrire
Solutions logicielles pour Markdown à essayer :
1. HedgeDoc
2. Jupyter Notebook
3. VSCodium avec une extension
4. MkDocs
Résultat
Solutions logicielles pour Markdown à essayer :
- HedgeDoc
- Jupyter Notebook
- VSCodium avec une extension
- MkDocs
Astuce
Il suffit de commencer la numérotation à 1., ensuite on peut mettre les numéros de son choix. Le rendu aura la bonne numérotation. Cela permet d'avoir une très grande liste, d'ajouter au milieu ou supprimer, sans avoir à refaire la numérotation.
Insérer un lien⚓︎
On suit le modèle
[Texte du lien](lien)
Exemples :
À écrire
Solutions logicielles pour Markdown à essayer :
1. [HedgeDoc](https://demo.hedgedoc.org/new)
2. [Jupyter Notebook](https://notebook.basthon.fr/)
3. [VSCodium](https://vscodium.com/) avec une extension
4. [MkDocs](https://ens-fr.gitlab.io/mkdocs/)
Résultat
Solutions logicielles pour Markdown à essayer :
- HedgeDoc
- Jupyter Notebook
- VSCodium avec une extension
- MkDocs
Insérer une image⚓︎
Image sur Internet⚓︎
Pour les premières expériences, on utilise une image disponible sur Internet ; il faut son url.
On suivra le modèle
Par exemple, sur le site ISO Republic, on trouve des images sous licences libres. On peut copier le lien de téléchargement d'une image comme celle-ci : https://isorepublic.com/wp-content/uploads/2022/03/iso-republic-graffiti-fish-street-art-1100x574.jpg
L'url commence par http, n'est pas très grande et se termine par .jpg ou .png ou .svg.
On peut l'insérer ainsi 
Ce qui donne
Important
- Il faut commencer par
!, sinon c'est juste un lien. - On met un texte alternatif pour détecter une erreur d'accès à l'image, mais aussi pour aider les déficients visuels aider par des robots de lecture.
- On met un lien correct d'image. Ne pas mettre le lien d'une page où on trouve l'image. Il faut le lien de l'image.
- On verra après comment redimensionner l'image.
- Vous trouverez d'autres sites pour des images libres sur cette page.
Mettre quelques mots en relief⚓︎
N'utiliser que rarement ces possibilités.
- Les titres seront naturellement mis en relief. N'en n'ajouter pas !
- Dans ce document, il y a beaucoup trop de mots en gras (emphase forte), vous devez en utiliser moins. Utilisez plutôt l'emphase faible avec parcimonie.
On suit le modèle :
À écrire
Dans ce document, il y a beaucoup trop de mots en **gras** (emphase forte),
vous devez en utiliser moins. Utilisez _plutôt_ l'emphase faible avec parcimonie.
Résultat
Dans ce document, il y a beaucoup trop de mots en gras (emphase forte), vous devez en utiliser moins. Utilisez plutôt l'emphase faible avec parcimonie.
Créer un tableau⚓︎
On suit le modèle :
À écrire
| A | B | C |
|---|---|---|
| Riri | Fifi | Loulou |
| Pif | Paf | Ploum |
Il est inutile de bien aligner les |.
Il faut juste la bonne quantité.
Résultat
| A | B | C |
|---|---|---|
| Riri | Fifi | Loulou |
| Pif | Paf | Ploum |
Et ensuite ?⚓︎
On se réfère à Bases de Markdown pour plus de détails.
Cela permet de créer une belle page avec HedgeDoc, mais aussi un document élaboré avec Jupyter.
Pour utiliser des possibilités avancées de Markdown,