Aller au contenu

Extension Aperçu Markdown

Un aperçu en direct, côte à côte, du document Markdown actif, rendu dans un panneau ancrable qui se met à jour pendant la frappe. Le moteur de rendu est sans dépendance (il utilise la vue texte enrichi intégrée de Qt, pas un moteur web), cette extension est donc toujours disponible et n'ajoute aucune dépendance lourde.

Où la trouver

Affichage ▸ Aperçu Markdown ouvre (ou ferme) le panneau d'aperçu pour l'onglet courant. Le panneau privilégie le côté droit et peut être déplacé, détaché ou mis en onglet comme tout autre panneau.

Comportement

  • Rendu en direct. L'aperçu se rafraîchit pendant la frappe, avec un délai anti-rebond pour que la saisie reste réactive (le délai s'assouplit automatiquement pour les très gros fichiers).
  • Suivre le curseur. Avec Suivre le curseur activé (barre d'outils), l'aperçu défile vers le bloc que vous éditez dès que le curseur passe à une autre ligne. Comme seul un déplacement du curseur le fait défiler, une Recherche amène l'aperçu sur la correspondance puis le laisse tranquille : vous pouvez vous en éloigner et l'aperçu reste où vous l'avez mis jusqu'à ce que vous bougiez à nouveau le curseur. Désactivez l'option pour faire défiler l'aperçu de façon totalement indépendante. Le réglage est mémorisé.
  • Sensible au thème. Les couleurs de l'aperçu proviennent du thème actif de l'éditeur (texte, blocs de code, citations, liens) ; l'aperçu s'accorde donc à un thème clair ou sombre et se met à jour en direct quand vous changez de thème. Vous pouvez affiner ces couleurs dans l'Éditeur de thèmes, sous les catégories Markdown.
  • Exporter / ouvrir dans le navigateur. La barre d'outils peut exporter le HTML rendu vers un fichier ou l'ouvrir dans votre navigateur par défaut. Dans les deux cas vous obtenez une page propre et autonome : un balisage simple et sémantique, sans l'échafaudage dont l'aperçu a besoin pour lui-même, et une feuille de style claire fixe afin que le fichier partagé se lise normalement quel que soit votre thème d'éditeur.
  • Taille du panneau. L'aperçu conserve une part de la fenêtre plutôt qu'une largeur fixe : il grandit et rétrécit avec elle — voir Disposition enregistrée.

Visibilité de l'aperçu

La visibilité de l'aperçu est mémorisée par fichier, pendant une session comme entre les redémarrages :

  • Les fichiers Markdown (.md, .markdown, .mdown, .mkd, .mkdn, .mdwn, .markdn, .mdtxt) ouvrent l'aperçu automatiquement la première fois que vous les affichez. Ce défaut d'« ouverture automatique » est un réglage persistant sous Affichage ▸ Ouvrir automatiquement l'aperçu Markdown.
  • Les autres fichiers non — mais vous pouvez ouvrir l'aperçu sur n'importe quel fichier avec Affichage ▸ Aperçu Markdown, et il sera rendu comme du Markdown.
  • Au sein d'une session, votre choix pour un onglet est restauré quand vous y revenez.
  • Entre les redémarrages, votre choix explicite pour un fichier est mémorisé : fermez l'aperçu sur un fichier et il reste fermé à la prochaine ouverture de ce fichier ; ouvrez l'aperçu sur un fichier qui ne s'ouvrirait pas automatiquement et il se rouvre. Les fichiers que vous n'avez jamais touchés explicitement suivent simplement le défaut d'ouverture automatique à chaque fois — activer l'ouverture automatique plus tard ouvre donc encore les aperçus que vous n'avez jamais délibérément fermés.

Ce qui est rendu

  • Mise en forme en ligne — *italique*, **gras**, ***gras italique***, ~~barré~~, code en ligne et sauts de ligne forcés.
  • Titres — aussi bien la forme # que la forme soulignée (setext).
  • Listes — ordonnées et non ordonnées, imbriquées, serrées ou aérées (une liste aérée reçoit l'espacement des paragraphes), commençant au numéro que vous avez écrit, et listes de tâches : - [ ] et - [x] deviennent ☐ et ☑.
  • Tableaux — tableaux à barres verticales avec un alignement par colonne (à gauche, centré, à droite). Une ligne trop courte est complétée, une cellule en trop est ignorée, et un tableau large se replie au lieu d'être tronqué.
  • Code — blocs clôturés comme blocs indentés, dessinés dans un cadre bordé et rempli, en police à largeur fixe : un bloc se détache du texte, et les diagrammes ASCII et les colonnes alignées gardent leur forme.
  • Liens et images — en ligne, par référence ([texte][ref] avec sa définition n'importe où dans le fichier) et adresses http://, https:// ou www. nues, qui deviennent des liens d'elles-mêmes. Les chemins d'images sont résolus relativement au fichier.
  • Citations et lignes horizontales.
  • Front matter YAML — le bloc de métadonnées --- … --- que certains outils attendent tout en haut d'un fichier est montré comme un bloc de code yaml, et non pris pour un titre.

Le HTML brut est montré comme du texte, délibérément : le balisage est échappé au lieu d'être exécuté, de sorte que prévisualiser un document que vous n'avez pas écrit ne peut rien exécuter. Les blocs HTML et les notes de bas de page ne sont pas rendus.

Quels liens s'ouvrent

Cliquer sur un lien dans l'aperçu ne l'ouvre que si la destination est http, https ou mailto ; un #fragment fait défiler l'aperçu jusqu'à ce titre. Toute autre destination — un chemin file:, un chemin simple ou relatif, une adresse javascript:, le schéma propre à une application — est ignorée, et la barre d'état indique quel lien n'a pas été ouvert et pourquoi. La raison est le document lui-même : un fichier Markdown que vous avez cloné ou téléchargé est le texte de quelqu'un d'autre, et un seul clic dedans ne doit pas pouvoir lancer un programme sur votre machine.

Le survol d'un lien montre où il mène avant que vous ne cliquiez, avec une deuxième ligne quand c'est un lien que l'aperçu n'ouvrira pas.

Voir aussi

  • Aperçu HTML — aperçu haute fidélité (CSS/JavaScript) pour HTML et PHP, via QtWebEngine.
  • Éditeur de thèmes — ajuster les couleurs Markdown de l'aperçu.