Pour que les paragraphes restent identiques dans les autres outils, nous avons défini les règles de la touche Entrée
Dans un éditeur Markdown, avez-vous déjà appuyé une seule fois sur Entrée et vu l’écran descendre de deux lignes, ou vu des paragraphes séparés à l’écran se retrouver regroupés en un seul bloc sur GitHub ? Ce sont les deux faces d’une même question.
Que devrait-il se passer lorsqu’on appuie sur Entrée dans un éditeur Markdown ?
À l’écran, il ne devrait descendre que d’une ligne. Mais dans le fichier, deux sauts de ligne sont nécessaires pour séparer les paragraphes. Cette différence, qui paraît simple, détermine la nature de l’éditeur.
mote a choisi une méthode qui permet d’écrire les paragraphes naturellement tout en préservant le fichier tel quel.
Une seule pression fait descendre d’une ligne
Dans mote, Entrée crée un nouveau paragraphe.
À l’écran, on descend d’une ligne, et deux sauts de ligne sont insérés dans le fichier. S’il y a déjà un saut de ligne à côté du curseur, il compte comme la moitié de la séparation. Ainsi, quel que soit ce qui l’entoure, une seule pression produit une seule ligne.
Si vous souhaitez seulement changer de ligne au sein du même paragraphe, il suffit d’appuyer sur Maj+Entrée. Un seul saut de ligne est inséré dans le fichier, et la ligne suivante reste dans le même bloc. C’est utile lorsqu’il faut écrire des lignes les unes à la suite des autres, comme dans une adresse ou un poème.
La ligne vide entre les paragraphes n’apparaît pas séparément à l’écran. C’est parce qu’elle sert de séparateur entre les paragraphes. Le curseur ne s’y arrête pas non plus. Lorsque vous appuyez sur Retour arrière, la séparation entre les paragraphes disparaît d’un seul coup.
À chaque saisie, l’écran se déplace donc lui aussi d’une ligne.
Le fichier reste lui aussi conforme au Markdown
En Markdown, deux sauts de ligne séparent les paragraphes.
Considérer un seul saut de ligne comme un paragraphe pose problème. Dans les fichiers créés par d’autres personnes, l’espacement entre les paragraphes double, tandis que les fichiers créés dans mote se retrouvent regroupés en un seul paragraphe sur GitHub ou dans Pandoc.
Pour gérer ce modèle, Typora normalise le fichier lors de l’enregistrement. Il réduit par exemple trois lignes vides à une seule. mote ne corrige pas le fichier à votre place. Son principe est de ne pas ajouter ni supprimer des octets que l’utilisateur n’a pas saisis.
À la place, une règle supplémentaire a été établie.
Aucune ligne présente dans le fichier ne doit être à la fois invisible et impossible à modifier. Seule la ligne vide qui sépare les paragraphes est masquée ; toutes les autres sont affichées à l’écran.
Même les lignes vides avaient besoin de règles
Au début, seule la première ligne d’une série de lignes vides consécutives était considérée comme un séparateur de paragraphes.
Un phénomène étrange s’est alors produit. Lorsqu’on écrivait sur une ligne vide, le texte se rattachait au paragraphe situé en dessous, et il fallait appuyer une fois de plus sur Entrée pour créer un nouveau paragraphe. Après la suppression d’un paragraphe, il arrivait également qu’une ligne vide subsiste.
Il n’y avait qu’une seule cause. La séparation entre les paragraphes est formée d’une paire de deux sauts de ligne, mais un seul des deux était compté comme séparateur.
Désormais, les séparateurs et les paragraphes vides alternent au sein d’une série de lignes vides consécutives. Trois lignes vides dans le fichier deviennent une seule ligne vide à l’écran. Puisqu’un paragraphe vide constitue lui aussi une ligne, il a besoin d’un séparateur de chaque côté.
Les cas dans lesquels Entrée réutilise les sauts de ligne environnants ont également été clairement définis. Seul le saut de ligne qui relie deux lignes d’un même paragraphe est réutilisé. Un saut de ligne déjà utilisé pour séparer des paragraphes ne l’est pas une seconde fois.
Retour arrière suit le même principe. Lorsque vous supprimez un paragraphe vide, cette ligne et les séparateurs qui l’entourent disparaissent ensemble. Une seule pression ne retire qu’une seule ligne.
Ce comportement est vérifié simultanément à l’écran et dans le fichier. Le même test contrôle non seulement la hauteur des lignes à l’écran, mais aussi les octets réellement enregistrés dans le fichier.
En mode source, le fichier est affiché tel quel
Les règles relatives aux paragraphes ne s’appliquent qu’au mode live et au mode lecture.
En mode source, chaque ligne occupe une ligne à l’écran. Les lignes vides sont elles aussi affichées telles quelles, et le curseur peut aller n’importe où. Appuyer sur Entrée n’insère qu’un seul saut de ligne.
Si une interprétation a été ajoutée à l’affichage, il faut aussi un endroit où retirer cette interprétation et voir l’original. C’est également la raison pour laquelle le mode source est nécessaire pour manipuler des tableaux ou des blocs de code.
L’affichage fidèle impose aussi certaines limites
Si le fichier se termine par un saut de ligne, une ligne vide apparaît à la fin.
Le dernier saut de ligne n’est pas un séparateur entre deux blocs. C’est un emplacement où le prochain caractère peut être saisi. Il n’est donc pas masqué.
Les documents séparés par un seul saut de ligne dans les anciennes versions de mote apparaissent désormais comme un seul paragraphe. C’est le résultat conforme aux règles du Markdown. Pour séparer les paragraphes, il suffit d’appuyer une fois de plus sur Entrée à l’emplacement concerné. mote ne corrige pas le fichier en secret.
Un paragraphe n’existe ni uniquement à l’écran ni uniquement dans le fichier. mote a été conçu pour permettre une écriture naturelle à l’écran tout en laissant dans le fichier un contenu conforme au Markdown.