📐 最新の rumdl を Debian にインストール

rumdl とは

rumdl は Rust で書かれた Markdown のリンター兼フォーマッターです。markdownlint で誰もが知っているルールセット、つまり見出しレベル、リストのインデント、行の長さ、コードフェンスの書き方、リンク記法、行末の空白を見る MD001 から MD059 までのチェックをそのまま実装し、それをドキュメントツリー全体に対して秒ではなくミリ秒で走らせます。ほとんどのルールには修正が付いているので、rumdl check --fix は一覧を残す代わりに報告した箇所を直しますし、rumdl fmt はファイルをまるごと整形し直します。設定は rumdl.toml か pyproject.toml の [tool.rumdl] テーブル、すでにある .markdownlint.json は rumdl import で変換でき、rumdl server は Language Server Protocol を話すので、同じバイナリがエディタの中でも問題に下線を引きます。Ruff が Python にしていることを、そのまま Markdown でやるもの、と考えてください。

⚡ rumdl の主な機能

📦 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

# 最新の rumdl をインストール。単一の静的バイナリなので、
# Node も Python も要りません
sudo apt install rumdl

# インストールを確認。コマンドラインもエディタも、
# この 1 つのバイナリを使います
rumdl --version

# 最新の rumdl をインストール。単一の静的バイナリなので、
# Node も Python も要りません
apt install rumdl

# インストールを確認。コマンドラインもエディタも、
# この 1 つのバイナリを使います
rumdl --version

# カレントディレクトリ以下の Markdown をすべてリントする
rumdl check .

# 安全な修正があるものは、まとめて直す
rumdl check --fix .

# 編集の出発点になる rumdl.toml を書き出す
rumdl init

# ルールコードが何を意味するのかを読む
rumdl explain MD013

# サブコマンドとフラグの一覧
rumdl --help

🎯 基本的な使用例

チェックと修正:

# ファイル 1 つ、ディレクトリ、グロブのいずれでも
rumdl check README.md
rumdl check docs/
rumdl check "**/*.md"

# その場で直してから、残ったものを見る
rumdl check --fix .

# うるさいルールを 1 つ、この実行の間だけ止める
rumdl check --disable MD013 .

# いま気にしているルールだけを走らせる
rumdl check --enable MD001,MD009,MD047 .

# CI の注釈ステップにそのまま渡せる、
# 機械可読な出力
rumdl check --output-format json .

整形する:

# ファイルをその場で整形し直す
rumdl fmt docs/

# 何も書き込まないまま違反で終了する、
# CI で使うのはこちら
rumdl fmt --check docs/

# 受け入れる前に、変わる中身を確かめる
rumdl fmt --diff docs/

設定とルール:

# このリポジトリに rumdl.toml を作る
rumdl init

# すでにある markdownlint の設定を変換する
rumdl import .markdownlint.json

# いま実際に効いている設定と、その出どころ
rumdl config

# ルールを全部並べてから、ひとつを詳しく読む
rumdl rule
rumdl explain MD024

# シェル補完を、シェルが読む場所へ書き出す
rumdl completions bash | sudo tee /etc/bash_completion.d/rumdl > /dev/null

# このリポジトリに rumdl.toml を作る
rumdl init

# すでにある markdownlint の設定を変換する
rumdl import .markdownlint.json

# いま実際に効いている設定と、その出どころ
rumdl config

# ルールを全部並べてから、ひとつを詳しく読む
rumdl rule
rumdl explain MD024

# シェル補完を、シェルが読む場所へ書き出す
rumdl completions bash | tee /etc/bash_completion.d/rumdl > /dev/null

🚀 deb.griffo.io を選ぶ理由

• ✅ apt で入る唯一の場所: rumdl は Debian にも Ubuntu にも収録されていません。このリポジトリが上流公式のリリースをパッケージ化しています
• ✅ システム全体に、ランタイム不要: マシン上のどのリポジトリからも同じ /usr/bin/rumdl を使えます。裏に npm install も仮想環境もありません
• ✅ 自動更新: 上流のリリースから数時間以内にパッケージを更新するので、新しいルールと修正がただの apt upgrade で届きます
• ✅ 完全なパッケージ: 上流公式の Linux ビルドを /usr/bin/rumdl として導入。足しても当ててもいません
• ✅ 正直な依存関係: 静的リンクの Rust バイナリなので、チェックも修正も整形もサーバーも、ほかに何も入れずに動きます
• ✅ 2 つのアーキテクチャ: amd64 と arm64。同じパッケージがノート PC もサーバーも arm64 のビルドエージェントも面倒を見ます
• ✅ マルチディストリビューション: Bookworm、Trixie、Forky、Sid で動作
• ✅ 手間のかからない運用: 更新は通常の apt コマンドだけ

📦 パッケージのビルドリポジトリ

Debian パッケージは、この GitHub リポジトリで自動的にビルド・管理されています:

• 📐 rumdl-debian - 最新リリースのビルド

🔗 関連パッケージ

deb.griffo.io では、こちらも配布しています:

• Ruff - 同じ考え方を Python のソースに。Rust 製のリンターとフォーマッターが 1 つのバイナリに
• uv - Rust 並みに速い Python のパッケージ管理。ドキュメントをリントしているそのプロジェクトのために
• Neovim - rumdl server と話し、打ちながら診断を見せてくれるエディタ
• ripgrep - 同じ Markdown ツリーに対する、リンターでは答えられない検索に