📐 Neuestes rumdl unter Debian installieren

Was ist rumdl?

rumdl ist ein Markdown-Linter und -Formatierer, geschrieben in Rust. Es setzt genau das Regelwerk um, das alle schon von markdownlint kennen, die Prüfungen MD001 bis MD059 für Überschriftenebenen, Listeneinrückung, Zeilenlänge, den Stil von Codeblöcken, Linksyntax und Leerzeichen am Zeilenende, und es lässt sie in Millisekunden statt in Sekunden über einen ganzen Dokumentationsbaum laufen. Zu den meisten dieser Regeln gehört eine Korrektur, rumdl check --fix repariert also, was es meldet, statt dir nur eine Liste zu hinterlassen, und rumdl fmt formatiert eine Datei komplett neu. Konfiguriert wird über eine rumdl.toml oder eine [tool.rumdl]-Tabelle in der pyproject.toml, eine vorhandene .markdownlint.json wandelt rumdl import um, und rumdl server spricht das Language Server Protocol, dieselbe Binärdatei unterstreicht Probleme also auch in deinem Editor. Denk an das, was Ruff für Python ist, angewandt auf Markdown.

⚡ Hauptfunktionen von rumdl

📦 Installation aus 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

# Neuestes rumdl installieren
sudo apt install rumdl

# Installation prüfen
rumdl --version

# Neuestes rumdl installieren
apt install rumdl

# Installation prüfen
rumdl --version

# Jede Markdown-Datei unterhalb des aktuellen Verzeichnisses prüfen
rumdl check .

# Alles korrigieren, wofür es eine sichere Korrektur gibt
rumdl check --fix .

# Eine Startkonfiguration rumdl.toml schreiben, die du danach
# nach deinem Geschmack anpassen kannst
rumdl init

# Nachsehen, was ein Regelcode bedeutet
rumdl explain MD013

# Alle Unterbefehle und Optionen
rumdl --help

🎯 Grundlegende Verwendungsbeispiele

Prüfen und korrigieren:

# Eine Datei, ein Verzeichnis oder ein Glob-Muster
rumdl check README.md
rumdl check docs/
rumdl check "**/*.md"

# An Ort und Stelle korrigieren und dann zeigen, was übrig bleibt
rumdl check --fix .

# Eine zu laute Regel für diesen Lauf abschalten
rumdl check --disable MD013 .

# Nur die Regeln laufen lassen, die dich gerade interessieren
rumdl check --enable MD001,MD009,MD047 .

# Maschinenlesbare Ausgabe für einen Schritt in der CI, der
# daraus Annotationen macht
rumdl check --output-format json .

Formatieren:

# Die Dateien an Ort und Stelle neu formatieren
rumdl fmt docs/

# Fehlschlagen, ohne etwas zu schreiben, die Form für die CI
rumdl fmt --check docs/

# Die Änderungen ansehen, bevor du sie übernimmst
rumdl fmt --diff docs/

Konfiguration und Regeln:

# Eine rumdl.toml in diesem Repository anlegen
rumdl init

# Eine markdownlint-Konfiguration umwandeln, die es im
# Repository schon gibt
rumdl import .markdownlint.json

# Welche Konfiguration tatsächlich gilt und woher sie stammt
rumdl config

# Alle Regeln auflisten und dann eine davon ganz lesen
rumdl rule
rumdl explain MD024

# Shell-Vervollständigungen dorthin schreiben, wo deine
# Shell sie liest
rumdl completions bash | sudo tee /etc/bash_completion.d/rumdl > /dev/null

# Eine rumdl.toml in diesem Repository anlegen
rumdl init

# Eine markdownlint-Konfiguration umwandeln, die es im
# Repository schon gibt
rumdl import .markdownlint.json

# Welche Konfiguration tatsächlich gilt und woher sie stammt
rumdl config

# Alle Regeln auflisten und dann eine davon ganz lesen
rumdl rule
rumdl explain MD024

# Shell-Vervollständigungen dorthin schreiben, wo deine
# Shell sie liest
rumdl completions bash | tee /etc/bash_completion.d/rumdl > /dev/null

🚀 Warum deb.griffo.io?

• ✅ Die einzige apt-Quelle: rumdl ist weder in den Debian- noch in den Ubuntu-Archiven; dieses Repository paketiert das offizielle Upstream-Release
• ✅ Systemweit, ohne Laufzeitumgebung: ein /usr/bin/rumdl für jedes Repository auf der Maschine, ohne npm install und ohne virtualenv dahinter
• ✅ Automatische Updates: Pakete werden innerhalb von Stunden nach dem Upstream-Release aktualisiert, neue Regeln und Korrekturen kommen also mit einem schlichten apt upgrade
• ✅ Vollständiges Paket: der offizielle Upstream-Linux-Build als /usr/bin/rumdl, nichts hinzugefügt, nichts gepatcht
• ✅ Ehrliche Abhängigkeiten: eine statisch gelinkte Rust-Binärdatei, die nichts weiter braucht, um zu prüfen, zu korrigieren, zu formatieren oder als Server zu laufen
• ✅ Zwei Architekturen: amd64 und arm64, dasselbe Paket deckt damit deinen Laptop, deine Server und deine arm64-Build-Agenten ab
• ✅ Multi-Distribution: läuft auf Bookworm, Trixie, Forky und Sid
• ✅ Einfache Wartung: Updates mit den üblichen apt-Befehlen

📦 Paket-Build-Repository

Die Debian-Pakete werden in diesem GitHub-Repository automatisch gebaut und gepflegt:

• 📐 rumdl-debian - Builds der neuesten Releases

🔗 Verwandte Pakete

Ebenfalls verfügbar über deb.griffo.io:

• Ruff - Dieselbe Idee für Python-Quelltext, ein Linter und ein Formatierer in einer Rust-Binärdatei
• uv - Rust-schnelles Python-Packaging, für die Projekte, deren Doku du gerade prüfst
• Neovim - Ein Editor, der mit rumdl server spricht und die Diagnosen schon beim Tippen zeigt
• ripgrep - Für die Suchen über denselben Markdown-Baum, die ein Linter nicht beantworten kann