MDViewer

Premiers pas

2026-07-27 557 mots 3 min de lecture

Trois façons d’ouvrir du Markdown local, une visite de l’interface et les types de fichiers pris en charge.

Découverte

MDViewer affiche du Markdown à deux endroits : le lecteur dans le navigateur, qui ouvre les fichiers directement depuis votre propre ordinateur, et cette documentation. Les deux utilisent le même moteur de rendu et le même thème : ce que vous voyez ici correspond exactement au rendu de vos propres fichiers.

Ouvrir des fichiers locaux

Revenez à la page d’accueil du lecteur et utilisez l’une de ces méthodes :

Méthode Comment Quand l’utiliser
Ouvrir un dossier Cliquez sur « Ouvrir un dossier », ou appuyez sur O Lire une bibliothèque entière, avec recherche et liens entre fichiers
Ouvrir un fichier Cliquez sur « Ouvrir un fichier », ou Maj+O Ne lire qu’un seul document
Glisser-déposer Déposez un dossier ou un fichier .md n’importe où sur la page Le plus rapide

Note

Vos fichiers ne sont envoyés à aucun serveur. La lecture et le rendu se font entièrement dans le navigateur, et tout est libéré à la fermeture de l’onglet.

Compatibilité des navigateurs

L’ouverture d’un dossier repose sur la File System Access API :

  • Chrome / Edge / Opera 86+ : prise en charge complète, y compris la mémorisation du dernier dossier ouvert
  • Safari / Firefox : repli automatique sur <input webkitdirectory> et le glisser-déposer. La lecture fonctionne, mais le navigateur ne peut pas mémoriser le dossier : il faut le choisir à chaque fois.

Reprise de session

Quand vous ouvrez un dossier dans un navigateur compatible, le descripteur du répertoire est enregistré dans IndexedDB. À votre prochaine visite :

  • Si l’autorisation est toujours valide, vous revenez automatiquement au fichier et à la position de défilement où vous vous étiez arrêté
  • Si elle a expiré, une invite « continuer la lecture » apparaît dans un coin ; un clic suffit à réaccorder l’accès

La liste « Ouverts récemment » de la page d’accueil conserve vos 8 derniers espaces de travail.

L’interface

  • Arborescence à gauche : se déploie par niveau de dossier ; le champ du haut filtre par nom de fichier ; B la replie
  • Contenu au centre : largeur, taille du texte, interligne et police se règlent dans les réglages ; , les ouvre
  • Plan à droite : généré à partir des titres de niveau 2 à 4, il surligne la section courante pendant le défilement ; T le replie

Types de fichiers pris en charge

Lors de l’analyse d’un dossier, le lecteur retient :

  • Documents : .md .markdown .mdown .mkd .mdx .txt
  • Images : .png .jpg .gif .svg .webp .avif .bmp .ico (pour que les chemins relatifs du Markdown fonctionnent)

Il ignore .git, node_modules, dist, build, .obsidian et les dossiers similaires, ainsi que tous les fichiers cachés commençant par .. Une analyse couvre au maximum 6000 fichiers et 12 niveaux de profondeur.

Chemins relatifs

Les images et les liens écrits ainsi fonctionnent tels quels :

1
2
3
4
5

![Architecture](./images/arch.png)
![Image au niveau supérieur](../assets/logo.svg)

[Aller à une autre page](./advanced/config.md)
[Index de la section](../guide/)

Les images sont retrouvées dans l’espace de travail et converties en URL blob locales ; les liens vers des .md naviguent dans le lecteur sans recharger la page. Les cibles introuvables sont signalées en rouge avec une explication.

Pour aller plus loin