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 pour garder visible le bloc en cours d'édition. Désactivez-le pour faire défiler l'aperçu indépendamment. 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. Le HTML exporté utilise une feuille de style claire fixe, afin que le fichier partagé se lise normalement quel que soit votre thème d'éditeur.

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¶

Titres, gras / italique, code en ligne et blocs de code clôturés, listes ordonnées et non ordonnées, citations, lignes horizontales, liens, images (résolues relativement au fichier), liens automatiques et sauts de ligne forcés. Le texte est échappé en HTML et le HTML brut incorporé n'est pas exécuté : prévisualiser un document n'exécute donc jamais de balisage arbitraire.

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.