Accueil › Blog › Nouveautés front matter & aide-mémoire
Deux ajouts récents changent la façon d'utiliser l'aperçu Markdown ToolPico au quotidien : un panneau qui repère automatiquement le bloc de métadonnées YAML en tête de fichier, et un aide-mémoire de syntaxe accessible en un clic depuis la barre d'outils. Voici ce qui a changé, concrètement, avec des exemples d'usage.
--- ... --- contenant des paires clé/valeur (front matter YAML), l'éditeur affiche désormais ces métadonnées dans un panneau dédié, séparé du texte, au lieu de les mélanger à l'aperçu HTML du contenu.C'est une réponse directe à une limite bien connue des rédacteurs qui utilisent Jekyll, Hugo ou Astro : ces générateurs de site statique lisent un bloc de métadonnées (title:, date:, tags:...) placé tout en haut du fichier .md, avant le contenu réel. Jusqu'ici, un aperçu qui ne faisait pas cette distinction affichait ce bloc comme du texte brut ou une ligne horizontale suivie de clés YAML visibles telles quelles — pas très lisible, et surtout pas très utile.
Concrètement, si vous collez ou importez un fichier de ce type dans l'éditeur :
| Exemple de contenu collé (hypothétique) | Ce qui s'affiche maintenant |
|---|---|
--- | Panneau dédié listant title, date et tags ligne par ligne, au-dessus de l'aperçu |
# Objectifs de la semaine | Rendu normal en titre h1 dans l'aperçu, comme avant |
Le panneau se contente de lire et d'afficher ce qui a été détecté — il n'ajoute rien au fichier et ne modifie pas le texte de l'éditeur. Si aucun front matter n'est présent en tout début de fichier, le panneau reste simplement masqué et l'aperçu se comporte exactement comme avant.
--- isolé plus loin dans le document continue d'être traité comme une ligne horizontale classique.La barre d'outils propose déjà des boutons pour insérer directement du gras, une liste de tâches ou un tableau. Mais pour tout ce qui reste plus rare — la syntaxe exacte d'une note de bas de page, le marqueur d'un bloc de code avec langage, comment barrer un mot — la solution était jusqu'ici de sortir de la page pour chercher ailleurs. Le nouveau bouton d'aide-mémoire règle ce problème en gardant la référence directement à portée de clic.
Voici, à titre d'exemple, le type d'entrées que l'on retrouve dans ce panneau une fois ouvert :
| Syntaxe | Description dans l'aide-mémoire |
|---|---|
# Titre | Titre H1–H6 |
~~barré~~ | Texte barré |
```lang | Bloc de code coloré |
> citation | Citation |
1. élément | Liste numérotée |
Pris séparément, ces deux nouveautés répondent à deux frustrations différentes : l'une concerne un format de fichier particulier (les documents avec front matter, typiques des sites générés statiquement), l'autre concerne la mémoire de syntaxe au sens large, utile à n'importe quel rédacteur Markdown. Ensemble, elles réduisent le nombre de fois où il faut quitter la page — que ce soit pour comprendre pourquoi un bloc de métadonnées s'affiche mal, ou pour se rappeler comment écrire un élément de syntaxe précis.
Le reste du flux ne change pas : l'aperçu HTML continue de se mettre à jour en direct pendant la saisie, dans les mêmes vues (partagée, éditeur seul, aperçu seul), et rien de ce que vous écrivez n'est envoyé à un serveur.
Collez un fichier avec front matter YAML pour voir le nouveau panneau, ou ouvrez l'aide-mémoire depuis la barre d'outils — tout se passe dans votre navigateur.
Essayer l'outil →--- contenant des paires clé/valeur, un panneau dédié apparaît désormais au-dessus de l'aperçu pour lister ces métadonnées séparément du contenu, au lieu de les mélanger au rendu HTML.--- ; le texte dans l'éditeur reste strictement identique à ce que vous avez saisi ou importé, et le fichier téléchargé conserve le bloc de front matter tel quel.