Markdown étendu

Syntaxes spécifiques à Markdodo

Présentation

En plus du Markdown standard, Markdodo prend en charge des syntaxes étendues qui permettent d'aligner du texte, d'en modifier la taille, d'appliquer des couleurs de fond, d'insérer des sauts de ligne supplémentaires et de créer des blocs FAQ interactifs. Ces syntaxes sont propres à Markdodo et ne sont pas disponibles dans les parseurs Markdown classiques.

Comportement d'affichage : si un alignement ({align:...}) est appliqué, l'élément est rendu sous forme de div (bloc). Sans alignement, il est rendu sous forme de span (en ligne). Ce comportement s'applique à toutes les syntaxes étendues (taille, couleur, combinaison).

Alignement de texte

Vous pouvez aligner un bloc de texte en ajoutant un attribut {align:...} après le texte concerné. L'élément sera rendu sous forme de div.

Syntaxe

[Texte]{align:center}
[Texte]{align:right}
[Texte]{align:left}
[Texte]{align:justify}

Valeurs disponibles

Exemple

[Ce texte sera centré sur la page]{align:center}

[Ce texte sera aligné à droite]{align:right}

[Un long paragraphe justifié]{align:justify}

Taille de texte

Vous pouvez modifier la taille d'un bloc de texte en ajoutant un attribut {size:...} après le texte concerné. La taille est exprimée en em, une unité relative à la taille de texte par défaut.

Syntaxe

[Texte]{size:1.2}
[Texte]{size:0.8}

Valeurs acceptées

La valeur doit être un nombre décimal compris entre 0.8 et 1.8 :

Exemple

[Texte en taille normale]{size:1.0}

[Texte légèrement plus grand]{size:1.3}

[Texte en grand]{size:1.8}

[Texte plus petit, idéal pour les notes]{size:0.8}

Couleur de fond

Vous pouvez appliquer une couleur de fond à un élément de texte avec l'attribut {tag:#hexcolor}. La couleur hexadécimale est automatiquement adoucie pour garantir la lisibilité du texte noir par-dessus.

Syntaxe

[Texte]{tag:#e74c3c}
[Texte]{tag:#3498db}

Fonctionnement des couleurs

La couleur fournie en hexadécimal n'est pas appliquée telle quelle. Markdodo génère automatiquement une version douce (pastelle) de la même teinte, ce qui assure un contraste suffisant avec le texte noir affiché par-dessus. Par exemple :

Exemple

[Texte en rouge]{tag:#e74c3c}
[Texte en bleu]{tag:#3498db}
[Texte en vert]{tag:#27ae60}
[Rouge et grand]{tag:#e74c3c}{size:1.5}
[Bleu centré]{tag:#3498db}{align:center}

Saut de ligne supplémentaire

Le Markdown standard limite les sauts de ligne. Markdodo introduit la syntaxe {BR} pour forcer un saut de ligne visible sans créer un nouveau paragraphe.

Syntaxe

Première ligne{BR}
Deuxième ligne{BR}
Troisième ligne

Différence avec un nouveau paragraphe

Un saut de ligne vide dans Markdown crée un nouveau paragraphe (avec un espacement vertical conséquent). {BR} insère un saut de ligne simple à l'intérieur du même paragraphe, avec un espacement plus réduit.

Paragraphe 1

Paragraphe 2

Ligne A{BR}
Ligne B{BR}
Ligne C

Dans cet exemple, "Paragraphe 1" et "Paragraphe 2" sont séparés par un espacement de paragraphe, tandis que les lignes A, B et C sont serrées avec un saut de ligne simple entre chacune.

FAQ / Accordéons

Markdodo introduit une syntaxe compacte permettant de créer des blocs FAQ interactifs sur une seule ligne.

Syntaxe

$Question ?$(Réponse)

Exemple

$La syntaxe FAQ fonctionne-t-elle ?$(Oui)

$Peut-on mettre du Markdown dans la réponse ?$(Oui, totalement.)

Chaque FAQ est indépendante et peut être utilisée directement dans un paragraphe Markdown classique.

Combiner les syntaxes

Les syntaxes étendues peuvent être combinées pour appliquer simultanément alignement, taille et couleur à un même bloc de texte :

[Centré et grand]{align:center}{size:1.5}
[Rouge et grand]{tag:#e74c3c}{size:1.5}
[Bleu centré]{tag:#3498db}{align:center}
[Vert justifié]{tag:#27ae60}{align:justify}
[Violet petit à droite]{tag:#8e44ad}{size:0.8}{align:right}

L'ordre des attributs n'a pas d'importance. Vous pouvez enchaîner autant d'attributs que nécessaire après le texte.