PreviewMD pour Mac, iPad et iPhone
Obtenir

Comment ouvrir un fichier .md sur un Mac

Réponse courte : appuie sur la barre d’espace. Sélectionne le fichier dans le Finder, appuie sur la barre d’espace, et macOS l’affiche — à condition que quelque chose sur le Mac sache le faire. Par défaut, rien ne le sait, et c’est pourquoi un fichier .md s’ouvre en texte gris à largeur fixe, ou pas du tout. Installe un lecteur et la barre d’espace se met à marcher.

Cette page explique ce qu’est vraiment ce fichier, les trois façons d’en lire un, et comment choisir ce qui l’ouvre par défaut.

Ce qu’est un fichier .md

Un fichier .md, c’est du texte brut. Tu peux l’ouvrir dans n’importe quel éditeur et en lire chaque caractère — aucun format binaire, aucun conteneur zip, rien de propriétaire. Ce qui en fait du Markdown, c’est une poignée de conventions qui marquent la structure à l’intérieur de ce texte : une ligne qui commence par # est un titre, **texte** est en gras, une ligne qui commence par - est une puce.

# Release notes

- Fixed the thing that **crashed** on launch
- See `docs/setup.md` for the new steps

Voilà toute l’astuce. Le Markdown a été écrit en 2004 par John Gruber pour qu’un fichier texte reste lisible comme du texte tandis qu’un programme peut aussi le composer comme un document. Vingt ans plus tard, c’est dans ce format que sont écrits les READMEs de GitHub, la plupart des apps de notes et la plupart des sites de documentation — et c’est pour ça que des fichiers .md finissent sur ton Mac, que tu les aies choisis ou non.

L’extension varie un peu : .md est la plus courante, .markdown, .mdown et .mkd se rencontrent aussi, et c’est exactement la même chose.

Trois façons d’en lire un

La barre d’espace, dans le Finder

Coup d’œil est le moyen le plus rapide, quand quelque chose a appris à macOS à afficher le Markdown. Sélectionne le fichier, barre d’espace, lis, barre d’espace à nouveau. Aucune app ne s’ouvre, rien ne charge, et tu peux parcourir un dossier de notes aux touches fléchées.

C’est ce que PreviewMD ajoute : une extension Coup d’œil et des vignettes de documents, pour qu’un dossier de fichiers .md ressemble à un dossier de documents et non à un mur d’icônes vides identiques. C’est aussi pour ça que l’app est gratuite — la lecture ne devrait pas être la partie payante.

Un éditeur

N’importe quel éditeur Markdown l’ouvre correctement : tu vois la page rendue, tu peux taper dans la source, tu peux exporter. Lequel choisir dépend de ce que tu fais du fichier. Si tu lis surtout et corriges une ligne de temps en temps, une app basée sur les documents, qui laisse les fichiers là où ils sont, a la bonne forme. Si tu écris toute la journée avec des extensions et des rétroliens, une app à coffre t’ira mieux.

Le navigateur, ou TextEdit

Glisser un fichier .md dans Safari affiche le texte brut, pas une page rendue — le navigateur n’a aucune raison de le traiter comme du Markdown. TextEdit montre le texte aussi, et le réenregistrera volontiers, ce qui convient pour une correction rapide. Ni l’un ni l’autre n’affiche les tableaux, la coloration du code ou les maths.

Choisir ce qui ouvre les fichiers .md

macOS retient une app par type de fichier, et c’est facile à changer :

  1. Clique une fois sur un fichier .md dans le Finder pour le sélectionner.
  2. Appuie sur ⌘I, ou choisis Fichier ▸ Lire les informations.
  3. Sous Ouvrir avec, choisis l’app que tu veux.
  4. Clique sur Tout modifier… et confirme, pour que tous les fichiers .md suivent.

Coup d’œil est indépendant de ce choix. Il est assuré par celle des apps installées qui fournit une extension d’aperçu Markdown, et il marche même quand l’app elle-même ne tourne pas. Si la barre d’espace montre encore du texte brut après l’installation d’un lecteur, ouvre l’app une fois — le système enregistre l’extension au premier lancement — et va voir dans Réglages Système ▸ Général ▸ Ouverture et extensions ▸ Coup d’œil.

Lire le Markdown sur ce Mac

PreviewMD affiche le .md dans Coup d’œil, dessine des vignettes de documents dans le Finder, et s’ouvre sur une fenêtre où la page rendue côtoie sa source. Il est gratuit sur Mac, iPad et iPhone, ne tient aucun compte, et laisse tes fichiers exactement là où ils sont.

L’aide-mémoire Markdown de ce site montre chaque marque et son rendu — à gauche le résultat, à droite la source qui l’a produit.