showmd

showmd : La meilleure façon de prévisualiser vos fichiers Markdown sur macOS

Le format Markdown n'a jamais été conçu pour être lu sous forme de texte brut. Pourtant, sur macOS, l'aperçu par défaut (Quick Look) affiche souvent les fichiers .md comme un amas de symboles, de hachages et d'astérisques. showmd est la solution ultime pour corriger ce problème et offrir un rendu élégant, professionnel et complet de vos documents directement dans le Finder.

Qu'est-ce que showmd ?

showmd est un visualiseur Markdown natif pour macOS, gratuit et open source. Ce n'est ni un éditeur, ni une application de prise de notes complexe : c'est une extension de prévisualisation légère dont l'unique mission est de rendre vos fichiers Markdown lisibles en un instant. Que vous soyez développeur, rédacteur technique ou utilisateur d'outils d'IA, showmd transforme vos fichiers de code et de documentation en documents parfaitement mis en forme, respectant les standards modernes du web.

Contrairement aux solutions classiques, showmd gère les extensions de fichiers multiples comme .md, .markdown, .mdx, .mdc, .rmd, .qmd, .mdown, .mkd et .mkdn.

Caractéristiques principales de showmd

Un rendu complet et moderne

showmd utilise le moteur swift-markdown d'Apple pour garantir une compatibilité totale avec le GitHub Flavored Markdown (GFM). Cela inclut :

• Les tableaux et les listes de tâches.
• Le barré, les notes de bas de page et les liens automatiques.
• Les raccourcis emoji et les exposants/indices.

Support avancé pour l'IA et les développeurs

À l'ère de l'intelligence artificielle, les fichiers comme AGENTS.md ou CLAUDE.md pullulent. showmd est unique car il propose :

• Le rendu des balises XML d'IA : Les balises telles que <instructions>, <thinking> ou <example> sont affichées sous forme de blocs bordés et étiquetés au lieu de simples crochets angulaires illisibles.
• Gestion du Frontmatter YAML : Les métadonnées YAML au début des fichiers sont converties en un tableau rétractable élégant, masqué par défaut pour ne pas encombrer la lecture.

Diagrammes et Mathématiques

Plus besoin d'ouvrir un navigateur pour voir vos schémas. showmd intègre :

• Diagrammes Mermaid : Affichez vos diagrammes de flux, diagrammes de séquence et machines à états directement.
• LaTeX via KaTeX : Les expressions mathématiques en ligne ou en bloc ($x^2$) sont rendues avec une précision parfaite.

Expérience utilisateur macOS native

• Mode sombre automatique : L'application suit les réglages de votre système ou peut être configurée manuellement.
• Coloration syntaxique : Plus de 190 langages de programmation sont supportés pour les blocs de code.
• Vitesse instantanée : Sans surcharge, l'aperçu s'ouvre en moins d'une seconde.
• Confidentialité totale : Aucun cloud, aucun téléchargement de données, aucune télémétrie. Vos fichiers restent sur votre machine.

Cas d'utilisation (Use Case)

Pour les développeurs

Visualisez instantanément le fichier README.md d'un projet ou les journaux de modifications (CHANGELOG.md) sans lancer VS Code ou un terminal. Vérifiez vos diagrammes Mermaid avant de les pousser sur GitHub.

Pour les utilisateurs d'outils d'IA

Lisez les fichiers de configuration de vos agents IA (.cursorrules, etc.) de manière structurée. Les balises XML complexes deviennent claires grâce au rendu visuel de showmd.

Pour les rédacteurs et étudiants

Consultez vos notes de cours contenant des formules mathématiques complexes (LaTeX) ou vos articles de blog avec images locales intégrées sans quitter le Finder.

Comment utiliser showmd

L'installation et l'activation de showmd sont simples et rapides :

1. Installation : Téléchargez le fichier .dmg signé et notarizé ou utilisez Homebrew avec la commande : brew install --cask johannesnagl/tap/showmd.
2. Configuration initiale : Ouvrez l'application une fois. macOS vous demandera l'autorisation d'accéder aux données d'autres applications ; cliquez sur "Autoriser" pour permettre le partage des paramètres entre l'app et l'extension.
3. Activation : Allez dans Réglages Système -> Confidentialité et sécurité -> Extensions -> Quick Look. Cochez la case pour activer showmd.
4. Utilisation quotidienne : Sélectionnez n'importe quel fichier Markdown dans le Finder et appuyez sur la Barre d'espace.
   • Utilisez le bouton en haut pour basculer entre Rendered (Rendu) et Source (Texte brut).
   • Copiez le contenu en tant que HTML via le menu dédié si nécessaire.

FAQ

Q : Est-ce que showmd est gratuit ? R : Oui, il est totalement gratuit et open source sous licence MIT. Vous pouvez consulter le code source sur GitHub.

Q : Est-ce un éditeur de texte ? R : Non, showmd est uniquement un visualiseur (lecture seule). Son but est de fournir un aperçu rapide et fidèle via Quick Look.

Q : Comment voir le code source Markdown original ? R : Chaque fenêtre d'aperçu possède un commutateur en haut de l'interface permettant de passer du mode "Rendered" au mode "Source".

Q : Les images locales sont-elles affichées ? R : Oui, les chemins d'images relatifs sont résolus correctement dans Quick Look, affichant vos captures d'écran et schémas locaux sans problème.

Q : Quelles sont les alternatives ? R : Il existe Markdown Preview par Anybox (payant) ou QLMarkdown (gratuit mais sans interface de réglages). showmd se distingue par sa gestion gratuite et complète du Frontmatter, de Mermaid et des balises IA.