Sätteri: 高性能なMarkdownおよびMDX処理

Sätteriの機能

Sätteriは高性能なMarkdownおよびMDX処理ツールであり、Rustでコンテンツを解析・コンパイルし、JavaScriptでプラグインを実行できます。READMEによると、パイプラインは解析、変換、コンパイルを処理します。プロジェクトはBruits組織下のRust + TypeScriptモノレポで、ホームページはsatteri.bruits.orgです。READMEはユーザーにドキュメントサイト（インストール手順、APIリファレンス、使用例）とオンラインプレイグラウンドを案内しています。

アーキテクチャ

処理パイプラインは主にRustで実装され、NAPIバインディングを介してJavaScriptに公開されます。この設計により、CPU負荷の高い解析とコンパイルをRustで行い、プラグイン作成者は多くのWeb開発者に馴染みのあるJavaScriptで変換を記述できます。モノレポには7つのRustクレートと3つのnpmパッケージが含まれ、それぞれが明確な役割を持ちます。クレート`satteri-napi-binding`がRustとJavaScriptの橋渡しをします。READMEはクレートの説明以上の内部アーキテクチャを詳述していません。

パッケージ

Rustクレートには、高レベルパイプラインAPI用のメインクレート`satteri`、アリーナアロケータ`satteri-arena`、MDAST/HAST型と操作`satteri-ast`、Rust Pluginトレイトとランナー`satteri-plugin-api`、NAPIバインディング`satteri-napi-binding`、MDXコンパイル用`satteri-mdxjs-rs`（mdxjs-rsのフォーク、OXC対応）、CommonMark解析＋MDX拡張用`satteri-pulldown-cmark`（pulldown-cmarkのフォーク）が含まれます。npmパッケージは`satteri`（TypeScript層）、`satteri-expressive-code`（コードブロック用HASTプラグイン）、`vite-plugin-satteri`（.md/.mdxファイルをインポートするViteプラグイン）です。すべて対応するレジストリに公開されており、READMEにバージョンバッジがあります。

プラグインシステム

SätteriはRustとJavaScriptの両方で記述されたプラグインをサポートします。Rustでは`satteri-plugin-api`クレートが`Plugin`トレイトと型付きビジター、ランナーを定義します。JavaScriptプラグインはnpmパッケージ`satteri`が提供するTypeScript層を使って記述します。READMEはJavaScriptプラグインAPIのインターフェースを指定しておらず、詳細はドキュメントを参照するよう記載しています。パイプラインのステージは解析、変換、コンパイルですが、プラグインが各ステージにどうフックするかはREADMEでは説明されていません。設計はunifiedjsエコシステムの影響を受けています。

謝辞

READMEはSätteriが基盤としている複数のオープンソースプロジェクトに明示的に謝辞を述べています。unifiedjs（remarkやrehypeを含むコンテンツ構文木処理ツールのエコシステム）を引用しています。CommonMark解析にはpulldown-cmarkのフォークを、MDXコンパイルにはTitus Wormerによるmdxjs-rsのフォークを使用しています。MDXコンパイラのフォークはpulldown-cmarkとOXC（Rust製JavaScriptパーサ兼コンパイラ）を適用しています。高性能なRust-JavaScript相互運用の設計はLightning CSSに触発されました。OXCチームとLightning CSSプロジェクトに特に感謝しています。

ライセンスとリポジトリの状況

SätteriはMITライセンスのもとで提供されています（LICENSE抜粋参照）。ライセンスは、著作権表示を含めることを条件に、自由な使用、修正、配布、サブライセンスを許可します。ソフトウェアは「現状のまま」提供され、いかなる種類の保証もなく、著作者は請求や損害について責任を負いません。リポジトリメタデータによると、プロジェクトは1,112スター、29フォーク、22の未解決Issueがあります。アーカイブされていません。READMEは特定のバージョン番号やリリース日について言及しておらず、最新バージョン情報はホームページのドキュメントを参照する必要があります。 導入を検討する際は、Rust クレートと npm パッケージを同じ製品として一括評価せず、必要な層を先に決めます。Markdown だけなら高レベル API の入口を、MDX ならコンパイラの対応範囲を確認します。Vite を使う構成では vite-plugin-satteri が .md と .mdx をインポートする役割を持つため、既存のビルド設定との組み合わせを小さな文書で試します。コードブロック表示が必要なら satteri-expressive-code の導入範囲も分けて確認します。README はプラグインの詳細インターフェースを説明していないので、ドキュメントの該当 API と実際の変換結果を記録することが判断の中心になります。 Rust と JavaScript の境界では、変換前の Markdown、プラグインが受け取る構文木、最終的な HTML または JavaScript を同じ入力から保存して比較します。arena や AST のクレートを直接利用する場合は、上位 API と異なる更新単位になるため、依存バージョンを固定します。README にある playground は入力を試す入口ですが、そこでの結果を自分のビルド環境の性能や互換性の証拠にはしません。MDX の JSX、コードブロック、リンクのように処理結果を目視できる入力を用意し、既存の remark や rehype と出力差分を比較します。プラグインが失敗した場合のエラー形式も保存します。 導入前の確認では、使用する版と実行環境を記録し、README の記載と実際の結果を照合します。資料にない機能や保証は推測で補わず、確認できなかった点を採用条件として残します。テスト入力と実行ログを保存し、更新後にも同じ手順を再実行できる状態を作ります。実施記録には対象版と入力条件を残し、成功した結果だけでなく失敗した場合の出力も保存します。設定を変更した前後で同じ確認を繰り返せるようにし、READMEに書かれた機能と自分の環境で確認できた事実を分けます。採用判断では、導入できたかだけでなく、更新、障害、切り戻し、権限、ライセンスを同じ担当者が追跡できるかを確かめます。

編集部の結論

この資料だけで本番適性や性能を断定することはできません。bruits/satteri の README に示された用途が自分の構成と一致する人は、記載された導入手順と具体的なサンプルを隔離環境で確認してください。採用前には依存関係、対応バージョン、失敗時のログ、ライセンス条件を対象プロジェクトの実データで確認し、資料にない保証を前提にしない判断が必要です。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes