showmd

Qu'est-ce que showmd ?

showmd est une extension gratuite Quick Look pour macOS qui prévisualise les fichiers Markdown (.md et extensions associées) de manière plus lisible que le comportement par défaut du Finder. Son objectif principal est de rendre le Markdown avec mise en forme, tout en conservant l'accès au contenu source.

Au lieu d'afficher du texte brut lorsque vous appuyez sur Espace sur un fichier .md dans le Finder, showmd rend le Markdown et propose un basculement rendu/source. Il analyse également le frontmatter YAML en un tableau de métadonnées repliable, compatible avec les workflows courants de documentation et d'invite IA reposant sur la structure Markdown.

Fonctionnalités principales

• Prévisualisation Quick Look pour Markdown dans le Finder : Appuyez sur Espace sur un fichier Markdown pour voir le rendu formaté sans ouvrir de navigateur ou d'éditeur.
• Basculement rendu ↔ source : Passez du Markdown rendu à la source brute en un seul clic.
• Frontmatter YAML en tableau de métadonnées repliable : Détecte les « clés trouvées » dans le frontmatter et l'affiche dans un tableau replié par défaut.
• Fonctionnalités Markdown via un parseur Markdown : Prend en charge les éléments GitHub Flavored Markdown comme les tableaux, listes de tâches, barré, autolinks, notes de bas de page, et plus.
• Rendu syntaxique pour code et contenu spécial : Les blocs de code utilisent la coloration syntaxique adaptée (190+ langages listés), les maths LaTeX inline et en bloc sont rendus via KaTeX, et les diagrammes Mermaid sont rendus à partir des blocs de code.
• Rendu de tags orienté IA : Les tags de type XML courants dans les invites IA (par exemple, , , ) sont rendus comme des blocs étiquetés et encadrés au lieu d'angle brackets bruts.
• Pas de cloud ou d'envois en arrière-plan : La page indique « No cloud. No uploads. No telemetry », signifiant que les fichiers sont prévisualisés localement par défaut.
• Gestion des images inline dans Quick Look : Les chemins d'images relatifs se résolvent correctement pour que les captures d'écran/diagrammes locaux apparaissent dans la prévisualisation.

Comment utiliser showmd

1. Téléchargez showmd pour macOS et ouvrez-le une fois.
2. Dans Réglages Système → Confidentialité & Sécurité → Extensions → Quick Look, activez showmd (la page décrit cela comme un simple interrupteur).
3. Dans le Finder, sélectionnez un fichier Markdown et appuyez sur Espace pour le prévisualiser avec showmd.
4. Utilisez le basculement rendu/source pour passer du rendu formaté au Markdown sous-jacent. La page mentionne aussi une option pour copier en HTML.

Cas d'utilisation

• Lire de la documentation stockée en Markdown : Prévisualisez les fichiers README avec titres, listes, liens et tableaux formatés, sans quitter le Finder.
• Inspecter des fichiers d'invite/config IA en Markdown : Visualisez les fichiers d'instructions d'agent IA incluant des tags de type XML, rendus comme des blocs étiquetés pour un scan plus rapide.
• Vérifier le frontmatter YAML dans du contenu de site statique : Développez le tableau frontmatter pour vérifier titres ou clés de configuration, tout en le gardant replié pour une lecture courante.
• Contrôler du contenu technique avec code, maths ou diagrammes : Voyez les blocs de code avec coloration syntaxique, expressions LaTeX et diagrammes Mermaid rendus inline plutôt qu'en texte brut.
• Vérifier les images relatives dans notes/docs repo locaux : Confirmez que les images référencées par chemins relatifs s'affichent correctement dans la prévisualisation Quick Look.

FAQ

Comment activer showmd dans le Finder ?
Téléchargez showmd, ouvrez-le une fois, puis allez dans Réglages Système → Confidentialité & Sécurité → Extensions → Quick Look et activez l'extension. Au premier lancement, macOS peut demander l'autorisation d'accéder aux données d'autres apps ; cliquez sur Autoriser.

showmd remplace-t-il l'ouverture d'un navigateur ?
La page présente showmd comme un moyen de prévisualiser le Markdown directement dans Quick Look macOS, sans ouvrir de navigateur pour voir le rendu.

Puis-je basculer entre rendu et Markdown original ?
Oui. showmd propose un basculement rendu & source, décrit comme un seul clic.

Comment showmd gère-t-il le frontmatter YAML ?
Il analyse le frontmatter YAML en un tableau repliable, replié par défaut, que vous pouvez développer pour voir les métadonnées.

Y a-t-il une composante cloud ?
La page indique « No cloud. No uploads. No telemetry », indiquant que les prévisualisations sont gérées localement par défaut.

Alternatives

• Ouvrir les fichiers Markdown dans un visualiseur/éditeur Markdown dédié : Utilisez une application conçue pour le rendu et l’export Markdown. Ces options incluent souvent plus d’outils d’édition, tandis que showmd est spécifiquement positionné comme prévisualiseur Quick Look.
• Utiliser un rendu Markdown basé sur navigateur : Téléchargez ou collez le contenu dans un visualiseur en ligne pour obtenir un rendu. Comparé à showmd, cela ajoute une étape navigateur et peut ne pas garder les fichiers strictement locaux.
• S’appuyer sur le Quick Look par défaut de macOS : L’aperçu Espace du Finder affiche la source Markdown brute. C’est le plus simple mais moins lisible pour du contenu formaté comme les tableaux, diagrammes et maths.
• Utiliser une chaîne d’outils de documentation/site statique pour prévisualiser : Les serveurs de dev locaux peuvent rendre le Markdown avec le style complet du site, mais sont généralement plus lourds qu’un flux de travail Quick Look.