Cette page vise à documenter la syntaxe Markdown utilisée sur le site.
Le Markdown le plus standard se trouve documenté ici:
https://www.markdownguide.org/basic-syntax.
Si cette page n'est pas exhaustive vis à vis de la syntaxe du site AE,
elle a au moins le mérite de bien documenter le Markdown original.
Le réel parseur du site AE est une version tunée de mistune.
Les plus aventureux pourront aller lire ses tests
afin d'en connaître la syntaxe le plus finement possible.
En pratique, cette page devrait déjà résumer une bonne partie.
**texte**
*texte*
__texte__
~~texte~~
~~***__texte__***~~
<sup>texte</sup>
<sub>texte</sub>
http://www.site.com
[nom du lien](http://www.site.com)
[nom du lien](page://nomDeLaPage)
[nom du lien]![images/imageDuSiteAE.png](/chemin/vers/image.png titre optionnel)(options)
[nom du lien]![images/imageDuSiteAE.png](/chemin/vers/image.png titre optionnel)(options)
# Titre de niveau 1
## Titre de niveau 2
### Titre de niveau 3
etc...
Un nouveau paragraphe se fait avec deux retours à la ligne.
Un saut de ligne se force avec au moins deux espaces en fin de ligne.
Il est possible de créer des listes :
1. élément
2. élément
3. élément
Vous pouvez marquer plus simplement comme suit, les numéros se faisant tout seuls:
1. élément
1. élément
1. élément
- élément
- élément
- élément
Un tableau est obtenu en respectant la syntaxe suivante :
| Titre | Titre2 | Titre3 |
|-------|--------|--------|
| test | test | test |
| test | test | test |
Titre | Titre2 | Titre3 |
---|---|---|
test | test | test |
test | test | test |
L'alignement dans les cellules est géré comme suit, avec les ':' sur la ligne en dessous du titre:
| Titre | Titre2 | Titre3 |
|:-------|:------:|-------:|
| gauche | centre | droite |
Titre | Titre2 | Titre3 |
---|---|---|
gauche | centre | droite |
Une image est insérée ainsi : ![texte alternatif](/chemin/vers/image.png "titre optionnel")
On peut lui spécifier ses dimensions de plusieurs manières :
![image à 50%](/static/core/img/logo.png?50% "Image à 50%")
![image de 350 pixels de large](/static/core/img/logo.png?350 "Image de 350 pixels")
![image de 350x100 pixels](/static/core/img/logo.png?350x100 "Image de 350x100 pixels")
Image à 50% de la largeur de la page.
Image de 350 pixels de large.
Image de 350x100 pixels.
(devrait pouvoir détecter si vidéo ou non)
Un bloc de citation se crée ainsi :
> Ceci est
> un bloc de
> citation
Ceci est un bloc de citation
Il est possible d'intégrer de la syntaxe Markdown-AE dans un tel bloc.
On les crée comme ça1:
Je fais une note[^clef].
[^clef]: je note ensuite où je veux le contenu de ma clef qui apparaîtra quand même en bas
Vous pouvez aussi utiliser des numéros pour nommer vos clefs.
Note plus complexe[^1]
[^1]:
je peux même faire des blocs
sur plusieurs lignes, comme d'habitude!
Une ligne peut être créée avec une ligne contenant 4 tirets (----
).
ceci est le contenu de ma clef↩