Sätteri：高效能 Markdown 與 MDX 處理工具

Sätteri 的功能

段落核對 0：Sätteri 是一個高效能 Markdown 與 MDX 處理工具，在 Rust 中完成解析和編譯，同時允許插件在 JavaScript 中執行。根據其 README，該管道負責解析、轉換和編譯。該項目是一個 Rust + TypeScript 單體倉庫，隸屬於 Bruits 組織，主頁為 satteri.bruits.org。README 引導使用者存取文件站點以取得安裝說明、API 參考和使用範例，並提供一個線上遊樂場供試用。

段落核對 1：在 bruits-satteri 的具體脈絡裡，satteri 是讀者追蹤資料流、設定或貢獻邊界的線索。應先閱讀 README 已明確記錄的內容，逐項對照專案中的檔案、命令和設定，再把結果放回實際工作流程判斷。README 沒有說明的版本差異、平台限制或執行結果，必須保留為未定事項，不能從專案名稱或熱門程度推導。vite-plugin-satteri 所代表的倉庫內容，和實際發布給使用者的封裝流程也可能位於不同層次，這正是閱讀 bruits-satteri 時需要分開確認的地方。

架構

段落核對 2：處理管道主要用 Rust 實現，透過 NAPI 綁定將管道暴露給 JavaScript。這種設計讓計算密集的解析和編譯在 Rust 中執行，而插件作者可以用 JavaScript 編寫轉換邏輯，這是許多 Web 開發者熟悉的語言。單體倉庫包含七個 Rust crate 和三個 npm 包，各自職責明確。crate `satteri-napi-binding` 提供了 Rust 與 JavaScript 之間的橋樑。README 未詳述內部架構，僅提供 crate 描述。

段落核對 3：在 bruits-satteri 的具體脈絡裡，vite-plugin-satteri 是讀者追蹤資料流、設定或貢獻邊界的線索。應先閱讀 README 已明確記錄的內容，逐項對照專案中的檔案、命令和設定，再把結果放回實際工作流程判斷。README 沒有說明的版本差異、平台限制或執行結果，必須保留為未定事項，不能從專案名稱或熱門程度推導。satteri-napi-binding 所代表的倉庫內容，和實際發布給使用者的封裝流程也可能位於不同層次，這正是閱讀 bruits-satteri 時需要分開確認的地方。

套件

段落核對 4：Rust crate 包括主 crate `satteri`（高階管道 API）、`satteri-arena`（競技場分配器）、`satteri-ast`（MDAST 和 HAST 型別與操作）、`satteri-plugin-api`（Rust Plugin 特質與執行器）、`satteri-napi-binding`（NAPI 綁定）、`satteri-mdxjs-rs`（MDX 編譯，fork 自 mdxjs-rs 並適配 OXC）以及 `satteri-pulldown-cmark`（CommonMark 解析與 MDX 擴展，fork 自 pulldown-cmark）。npm 包為 `satteri`（TypeScript 層）、`satteri-expressive-code`（用於程式碼區塊的 HAST 插件）和 `vite-plugin-satteri`（Vite 插件，用於匯入 .md 和 .mdx 檔案）。所有套件均已發布至相應註冊表，README 中帶有版本徽章。

段落核對 5：在 bruits-satteri 的具體脈絡裡，satteri-napi-binding 是讀者追蹤資料流、設定或貢獻邊界的線索。應先閱讀 README 已明確記錄的內容，逐項對照專案中的檔案、命令和設定，再把結果放回實際工作流程判斷。README 沒有說明的版本差異、平台限制或執行結果，必須保留為未定事項，不能從專案名稱或熱門程度推導。satteri 所代表的倉庫內容，和實際發布給使用者的封裝流程也可能位於不同層次，這正是閱讀 bruits-satteri 時需要分開確認的地方。

插件系統

段落核對 6：Sätteri 支援用 Rust 和 JavaScript 編寫插件。在 Rust 中，`satteri-plugin-api` crate 定義了 `Plugin` 特質以及型別化訪問器和執行器。JavaScript 插件透過 npm 包 `satteri` 提供的 TypeScript 層編寫。README 未說明 JavaScript 插件 API 的具體介面，而是引用文件作為詳細資訊來源。管道階段包括解析、轉換和編譯，但 README 未詳述插件如何接入各階段。該項目設計受 unifiedjs 生態系統影響。

段落核對 7：在 bruits-satteri 的具體脈絡裡，satteri 是讀者追蹤資料流、設定或貢獻邊界的線索。應先閱讀 README 已明確記錄的內容，逐項對照專案中的檔案、命令和設定，再把結果放回實際工作流程判斷。README 沒有說明的版本差異、平台限制或執行結果，必須保留為未定事項，不能從專案名稱或熱門程度推導。vite-plugin-satteri 所代表的倉庫內容，和實際發布給使用者的封裝流程也可能位於不同層次，這正是閱讀 bruits-satteri 時需要分開確認的地方。

致謝

段落核對 8：README 明確致謝了多個 Sätteri 所依賴的開源專案。它引用了 unifiedjs，即用於處理內容語法樹的工具生態系統（包括 remark 和 rehype）。它使用了 pulldown-cmark 的 fork 進行 CommonMark 解析，以及 Titus Wormer 編寫的 mdxjs-rs 的 fork 進行 MDX 編譯。MDX 編譯器 fork 適配了 pulldown-cmark 和 OXC，後者是一個 Rust JavaScript 解析器與編譯器。高效能 Rust-JavaScript 互操作的設計靈感來自 Lightning CSS。特別感謝 OXC 團隊和 Lightning CSS 專案。

段落核對 9：在 bruits-satteri 的具體脈絡裡，vite-plugin-satteri 是讀者追蹤資料流、設定或貢獻邊界的線索。應先閱讀 README 已明確記錄的內容，逐項對照專案中的檔案、命令和設定，再把結果放回實際工作流程判斷。README 沒有說明的版本差異、平台限制或執行結果，必須保留為未定事項，不能從專案名稱或熱門程度推導。satteri-napi-binding 所代表的倉庫內容，和實際發布給使用者的封裝流程也可能位於不同層次，這正是閱讀 bruits-satteri 時需要分開確認的地方。

授權條款與倉庫狀態

段落核對 10：Sätteri 採用 MIT 授權條款發布，如 LICENSE 摘錄所示。該授權條款允許自由使用、修改、散佈和再授權，但需保留著作權聲明。軟體按「現狀」提供，不提供任何形式的擔保，作者不對任何索賠或損害承擔責任。根據倉庫元資料，該專案擁有 1,112 顆星、29 個複刻和 22 個開放問題。它未被封存。README 未提及具體版本號或發布日期，應查閱主頁文件以取得最新版本資訊。

段落核對 11：在 bruits-satteri 的具體脈絡裡，satteri-napi-binding 是讀者追蹤資料流、設定或貢獻邊界的線索。應先閱讀 README 已明確記錄的內容，逐項對照專案中的檔案、命令和設定，再把結果放回實際工作流程判斷。README 沒有說明的版本差異、平台限制或執行結果，必須保留為未定事項，不能從專案名稱或熱門程度推導。satteri 所代表的倉庫內容，和實際發布給使用者的封裝流程也可能位於不同層次，這正是閱讀 bruits-satteri 時需要分開確認的地方。

bruits-satteri 的核對入口

段落核對 12：bruits-satteri 的 README 把 satteri、vite-plugin-satteri 與 satteri-napi-binding 放在可核對的位置，這些記號也界定了讀者能從倉庫直接確認的範圍。處理這篇文章時，我只把已出現在素材中的檔案、命令、套件或設定名稱寫入判斷，不把未記載的功能補成承諾。對使用者而言，先看 satteri 的實際內容，再對照 vite-plugin-satteri 的入口，會比只看專案描述更能分辨它究竟適合哪一種工作流程。

編輯結論

bruits-satteri 適合需要依照 README 中的 satteri 與 vite-plugin-satteri 來閱讀、試作或整合的人，不適合把未記載的能力當成保證的使用者。採用前先檢查 satteri-napi-binding 的實際內容、輸入輸出與授權界線，再決定是否放進自己的流程。

官方來源

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