Comment ouvrir un fichier .md

Un fichier Markdown est du texte brut. Tout ce qui ouvre du texte l’ouvre — la question est de savoir ce qui lui donne l’allure d’un document.

Ce que c’est

Un fichier `.md` est un fichier texte avec quelques conventions dedans : un dièse pour un titre, des astérisques pour la mise en valeur, des tirets pour une liste. Rien dans le fichier n’est binaire et rien n’est compressé, donc un éditeur de texte vous en montre immédiatement toute la vérité.

C’est aussi pour cela qu’il a l’air inachevé. Les conventions sont des instructions destinées à un moteur de rendu, et tant que rien ne les rend, vous lisez les instructions plutôt que le document.

Sur un ordinateur

Sous Windows, Notepad l’ouvre et affiche le texte brut. Sur un Mac, TextEdit fait de même, même s’il peut d’abord proposer de convertir le fichier — refusez, et il reste brut. Sur les deux, VS Code affiche un aperçu en direct à côté de la source, et c’est ce qui ressemble le plus à la page finie sans quitter votre éditeur.

Faire glisser le fichier sur une fenêtre de navigateur ne fonctionne pas comme on l’imagine : le navigateur affiche le texte brut ou propose de le télécharger, parce qu’aucun navigateur ne rend le Markdown de lui-même.

Sur un téléphone

La plupart des téléphones n’ont aucun lecteur Markdown installé et proposeront d’ouvrir le fichier dans une application de notes ou de fichiers, qui affiche le texte tel qu’il est écrit. Sous iOS, Fichiers en donne un aperçu en texte brut ; sous Android, le comportement dépend de l’éditeur de texte installé.

Le convertir d’abord en HTML va généralement plus vite que de chercher un lecteur, parce que chaque téléphone a déjà un navigateur et que chaque navigateur ouvre le HTML.

Ce qui coince le plus souvent

Un fichier enregistré sous le nom `notes.md.txt` par un éditeur de texte qui a ajouté sa propre extension ne sera reconnu par rien de ce qui cherche du Markdown. Renommez-le et le problème disparaît.

Les tableaux, les notes de bas de page et les listes de tâches ne figurent pas dans la spécification Markdown d’origine : un lecteur qui affiche littéralement les barres verticales et les crochets n’est donc pas cassé — il met en œuvre le cœur et pas les extensions.