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 [mistune](https://github.com/lepture/mistune). Les plus aventureux pourront aller lire ses [tests](https://github.com/lepture/mistune/blob/master/tests/fixtures) afin d'en connaître la syntaxe le plus finement possible. En pratique, cette page devrait déjà résumer une bonne partie. ## 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 texte^en exposant^ : `<sup>texte</sup>` - Mettre du texte~en 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](http://www.site.com) - 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](page://nomDeLaPage) - On peut également utiliser une image pour les liens : `[nom du lien](options)` [nom du lien](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 1. élément 1. é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 1. élément 1. é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 : ``  On peut lui spécifier ses dimensions de plusieurs manières : ```    ```  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 ça[^key]: [^key]: ceci est le contenu de ma clef ``` 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 (`----`).