Cette page vise à documenter la syntaxe Markdown utilisée sur le site.

# Markdown-AE Documentation

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 comrak.

## Basique

- Mettre le texte en gras : `**texte**`
- Mettre le texte en italique : `*texte*`
- Souligner le texte : `__texte__`
- Barrer du texte : `~~texte~~`
- On peut bien sûr tout combiner : `~~***__texte__***~~`
- Mettre du texteen exposant : `<sup>texte</sup>`
- Mettre du texteen indice : `<sub>texte</sub>`

## Liens

- Les liens simples sont détectés automatiquement : `http://www.site.com`

http://www.site.com

- Il est possible de nommer son lien : `[nom du lien](http://www.site.com)`

nom du lien

- Les liens peuvent être internes au site de l’AE, on peut dès lors éviter d’entrer l’adresse complète d’une page : `[nom du lien](page://nomDeLaPage)`

nom du lien

- On peut également utiliser une image pour les liens : `[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)

## Titres

- Plusieurs niveaux de titres sont possibles

    # Titre de niveau 1
    ## Titre de niveau 2
    ### Titre de niveau 3
    etc...

# Titre de niveau 1

## Titre de niveau 2

### Titre de niveau 3

## Paragraphes et sauts de ligne

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.

## Listes

Il est possible de créer des listes :

### ordonnées :

    1. élément
    2. élément
    3. élément

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

1. élément
2. élément
3. élément

### non ordonnées :

    - élément
    - élément
    - élément

- élément
- élément
- élément

## Tableaux

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

## Images et contenus

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)

## Blocs de citations

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.

## Note de bas de page

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!

## Échapper des caractères

- Il est possible d’ignorer un caractère spécial en l’échappant à l’aide d’un \
- L’échappement de blocs de codes complet se fera à l’aide de balises <nosyntax></nosyntax>

## Autres (hérité de l’ancien wiki)

Une ligne peut être créée avec une ligne contenant 4 tirets (`----`).

1. ceci est le contenu de ma clef ↩