📐 Installer le dernier rumdl sur Debian

Qu'est-ce que rumdl ?

rumdl est un linter et formateur Markdown écrit en Rust. Il implémente le jeu de règles que tout le monde connaît déjà par markdownlint, les contrôles MD001 à MD059 sur les niveaux de titre, l'indentation des listes, la longueur des lignes, le style des blocs de code, la syntaxe des liens et les espaces en fin de ligne, et il les passe sur une arborescence de documentation en millisecondes plutôt qu'en secondes. La plupart de ces règles ont une correction, si bien que rumdl check --fix répare ce qu'il signale au lieu de vous laisser une liste, et rumdl fmt reformate un fichier de bout en bout. La configuration tient dans un fichier rumdl.toml ou dans une table [tool.rumdl] de pyproject.toml, un .markdownlint.json existant se convertit avec rumdl import, et rumdl server parle le Language Server Protocol : le même binaire souligne donc les problèmes dans votre éditeur. Voyez-le comme ce que Ruff est à Python, appliqué au Markdown.

⚡ Fonctionnalités clés de rumdl

📦 Installation depuis deb.griffo.io

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt update

install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt update

sudo apt install extrepo
sudo extrepo enable griffo
sudo apt update

# Installer le dernier rumdl
sudo apt install rumdl

# Vérifier l'installation, le binaire est installé dans
# /usr/bin/rumdl
rumdl --version

# Installer le dernier rumdl
apt install rumdl

# Vérifier l'installation, le binaire est installé dans
# /usr/bin/rumdl
rumdl --version

# Analyser tous les fichiers Markdown sous le répertoire
# courant
rumdl check .

# Corriger tout ce qui a une correction sûre
rumdl check --fix .

# Écrire un rumdl.toml de départ que vous pourrez modifier
rumdl init

# Voir ce que signifie un code de règle
rumdl explain MD013

# Toutes les sous-commandes et toutes les options
rumdl --help

🎯 Exemples d'utilisation de base

Vérifier et corriger :

# Un fichier, un répertoire ou un motif
rumdl check README.md
rumdl check docs/
rumdl check "**/*.md"

# Corriger sur place, puis afficher ce qu'il reste
rumdl check --fix .

# Désactiver une règle trop bavarde le temps d'un passage
rumdl check --disable MD013 .

# N'exécuter que les règles qui vous intéressent sur le
# moment
rumdl check --enable MD001,MD009,MD047 .

# Sortie exploitable par une étape d'annotation en CI
rumdl check --output-format json .

Formater :

# Reformater les fichiers sur place
rumdl fmt docs/

# Échouer sans rien écrire, la forme utilisée en
# intégration continue
rumdl fmt --check docs/

# Voir les changements avant de les accepter
rumdl fmt --diff docs/

Configuration et règles :

# Créer rumdl.toml dans ce dépôt
rumdl init

# Convertir une configuration markdownlint existante
rumdl import .markdownlint.json

# Quelle configuration s'applique vraiment, et d'où elle vient
rumdl config

# Lister toutes les règles, puis en lire une en entier
rumdl rule
rumdl explain MD024

# Complétions du shell, écrites là où votre shell les lit
rumdl completions bash | sudo tee /etc/bash_completion.d/rumdl > /dev/null

# Créer rumdl.toml dans ce dépôt
rumdl init

# Convertir une configuration markdownlint existante
rumdl import .markdownlint.json

# Quelle configuration s'applique vraiment, et d'où elle vient
rumdl config

# Lister toutes les règles, puis en lire une en entier
rumdl rule
rumdl explain MD024

# Complétions du shell, écrites là où votre shell les lit
rumdl completions bash | tee /etc/bash_completion.d/rumdl > /dev/null

🚀 Pourquoi choisir deb.griffo.io ?

• ✅ La seule source apt : rumdl n'est ni dans les dépôts Debian ni dans ceux d'Ubuntu ; ce dépôt empaquette la release officielle upstream
• ✅ Pour tout le système, sans runtime : un seul /usr/bin/rumdl pour tous les dépôts de la machine, sans npm install et sans virtualenv derrière
• ✅ Mises à jour automatiques : les paquets sont mis à jour quelques heures après chaque version upstream, les nouvelles règles et corrections arrivent donc avec un simple apt upgrade
• ✅ Paquet complet : la compilation Linux officielle upstream installée dans /usr/bin/rumdl, rien d'ajouté, rien de rustiné
• ✅ Dépendances honnêtes : un binaire Rust lié statiquement qui n'a besoin de rien d'autre pour analyser, corriger, formater ou servir
• ✅ Deux architectures : amd64 et arm64, le même paquet couvre donc votre portable, vos serveurs et vos agents de construction arm64
• ✅ Multi-distribution : fonctionne sur Bookworm, Trixie, Forky et Sid
• ✅ Maintenance simple : des mises à jour avec les commandes apt habituelles

📦 Dépôt de construction du paquet

Les paquets Debian sont construits et maintenus automatiquement dans ce dépôt GitHub :

• 📐 rumdl-debian - Constructions des dernières versions

🔗 Paquets associés

Également disponibles sur deb.griffo.io :

• Ruff - La même idée pour les sources Python, un linter et un formateur Rust en un seul binaire
• uv - L'empaquetage Python à la vitesse de Rust, pour les projets dont vous analysez la documentation
• Neovim - Un éditeur qui saura parler à rumdl server et afficher les diagnostics à la frappe
• ripgrep - Pour les recherches dans la même arborescence Markdown auxquelles un linter ne répond pas