Lint Markdown
VMark embarque un moteur de lint intégré qui détecte les problèmes de correction, pas les préférences de style. Le lint s'exécute à la demande (Cmd-Shift-L ou Outils → Vérifier le Markdown) et présente les résultats en ligne sous forme de surlignages dans la gouttière, avec un badge dans la barre d'état et une navigation F2 entre les diagnostics.
Ce que le lint est et n'est pas
Le lint de VMark est un vérificateur de correction :
- Références croisées cassées
- Références de lien / note de bas de page non définies
- Blocs de code délimités non fermés
- Tableaux avec un nombre de colonnes incohérent
- Niveaux de titre qui sautent (h1 → h3)
- Images sans texte alternatif
- Texte de lien vide ou
hrefvide
Le lint de VMark n'est pas un applicateur de style. Il ne signalera pas :
- Longueur de ligne
- Style de marqueur de liste (
-vs*) - Style de marqueur d'emphase (
_vs*) - Style de titre (
#vs souligné) - Espaces de fin de ligne
Pour l'application du style, utilisez un outil distinct comme prettier --check en dehors de VMark.
Référence des règles
| ID de règle | Gravité | Description |
|---|---|---|
| E01 | Erreur | Référence non définie : [lien][manquant] pointe vers une définition qui n'existe pas |
| E02 | Erreur | La ligne de tableau a un nombre de colonnes erroné (incohérence avec la ligne d'en-tête) |
| E03 | Erreur | Lien inversé — ressemble à (texte)[url] au lieu de [texte](url) |
| E04 | Erreur | Titre ATX manquant un espace après # (par ex. ##Titre devrait être ## Titre) |
| E05 | Erreur | Espace à l'intérieur des marqueurs d'emphase — * mot * ne s'affichera pas en italique |
| E06 | Erreur | Bloc de code délimité non fermé — le fichier se termine par une fence ``` ouverte |
| E07 | Erreur | Définition de référence de lien dupliquée (le même [label]: apparaît deux fois) |
| E08 | Erreur | href de lien vide — [texte]() |
| W01 | Avertissement | Niveau de titre sauté (h2 attendu, h3 trouvé) |
| W02 | Avertissement | Image manquant un texte alternatif — accessibilité |
| W03 | Avertissement | Définition de référence de lien inutilisée (définie mais jamais liée) |
| W04 | Avertissement | Le fragment d'ancre ne correspond à aucun titre — #section pour une section qui n'existe pas |
| W05 | Avertissement | Texte de lien vide — [](url) |
| M001 | Erreur | Fichier image introuvable au chemin local |
| M002 | Erreur | Fichier lié introuvable au chemin local |
| Y001 | Erreur | Erreur d'analyse YAML (pour les fichiers YAML) |
| Y002 | Avertissement | Avertissement d'analyse YAML (pour les fichiers YAML) |
Déclenchement du lint
| Déclencheur | Action |
|---|---|
Cmd + Shift + L (macOS) / Ctrl + Shift + L (Win/Linux) | Exécuter le lint sur le document actif |
| Outils → Vérifier le Markdown | Identique au raccourci |
F2 | Sauter au diagnostic suivant |
Shift + F2 | Sauter au diagnostic précédent |
Pour les fichiers markdown avec des chemins de fichiers, la vérification de l'existence des liens s'exécute automatiquement aux côtés des règles synchrones — voir Vérification des liens.
Pour les fichiers YAML, les erreurs d'analyse apparaissent en direct dans la gouttière au fur et à mesure de votre saisie, et le même raccourci Cmd-Shift-L alimente le badge + la navigation F2.
Paramètres
Le moteur de lint a un seul interrupteur visible par l'utilisateur :
- Paramètres → Markdown → Activer le lint markdown — activer ou désactiver entièrement le moteur
Lorsqu'il est désactivé, le raccourci devient un no-op et aucun diagnostic n'apparaît dans la gouttière.
Voir aussi
- Vérification des liens — détection des liens / images locaux cassés
- Paramètres → Markdown → Lint