Markdown Editor : Aide
Voici une liste des éléments markdown intégrés par cette application :
- les trois types de titre (h1, h2, h3)
- text en gras
- text en italique
- text barré
- text sous ligné
- text en gras et italique
- text de taille h4 et h5
- citations
- listes à puce
- listes à numéros
- liens internet
- liens internet sans embeds
- text en "spoiler"
- text en code
- bloc de code
Fonctionnement de l’auto-markdown
Cet outil transforme un texte brut en Markdown de manière simple, selon des règles prédéfinies. Il ne fait pas d’analyse sémantique avancée, mais applique des heuristiques basées sur la forme des lignes.
Règles principales
Détection des titres (niveaux 2) :Une ligne est considérée comme un titre si :
- Elle n’est pas vide.
- Elle fait moins de 70 caractères.
- Elle ne se termine pas par un signe de ponctuation de fin de phrase (
. ! ? ,
). - Elle commence par une majuscule.
- Elle contient au maximum 2 signes de ponctuation (
, . : ; ! ?
). - Elle est précédée ou suivie d’une ligne vide, ou elle se termine par un deux-points
:
.
La ligne est alors convertie en titre Markdown de niveau 2.
Détection des listes explicites :Une ligne est reconnue comme un élément de liste si elle commence par :
- Un nombre suivi d’un point et d’un espace (
1.
,2.
, etc.) → liste ordonnée. - Un tiret, un astérisque ou un plus suivi d’un espace (
-
,*
,+
) → liste à puces.
Ces lignes sont converties en éléments de liste Markdown correspondants.
Liste implicite après un titre :Si une ligne suit immédiatement un titre (ou un élément terminé par :
) et que sa longueur est inférieure ou égale à 150 caractères, elle est automatiquement transformée en élément de liste à puces.
Les lignes qui ne correspondent à aucune des règles ci-dessus sont regroupées en paragraphes Markdown classiques.
Gestion des lignes vides :Les lignes vides servent à délimiter les paragraphes et réinitialisent certains états (ex. fin d’un titre).
Limitations et fonctionnalités non implémentées
- La transformation automatique des URL en liens Markdown n’est pas prise en charge dans ce code.
- Les citations (lignes entre guillemets) ne sont pas traitées.
- La transformation des liens enrichis (ex.
[texte] URL
) n’est pas gérée. - La détection des titres est basée sur plusieurs critères, pas seulement la casse ou la longueur.