README.md

June 28, 2026 · View on GitHub

Sätteri

Here the page is set, the loose locked fast, the words marked down.

High-performance Markdown and MDX processing. Parses and compiles in Rust, runs your plugins in JavaScript.

Check out the documentation for installation instructions, the API reference, and usage examples, try it online on the playground, or join us on Discord!

Packages

Sätteri is a Rust + TypeScript monorepo containing the following Rust crates:

NameDescriptionRegistryREADME
satteriHigh-level Rust API for the pipeline: parse, convert, compileSatteri Crates.io VersionREADME
satteri-arenaArena allocator and binary buffer primitivesSatteri Arena Crates.io VersionREADME
satteri-astMDAST and HAST node types, codecs, tree operations, and conversionSatteri AST Crates.io VersionREADME
satteri-plugin-apiRust Plugin trait for Rust plugins, typed visitors, and runnerSatteri Plugin API Crates.io VersionREADME
satteri-napi-bindingNAPI bindings exposing the Rust pipeline to JavaScriptREADME
satteri-mdxjs-rsMDX-to-JavaScript compiler, fork of mdxjs-rs adapted for OXCSatteri MDXJS Crates.io VersionREADME
satteri-pulldown-cmarkCommonMark parser with MDX extension support, fork of pulldown-cmarkSatteri pulldown-cmark Crates.io VersionREADME

And the following npm packages:

NameDescriptionRegistryREADME
satteriTypeScript layer: plugin API and top-level functionsSatteri npm VersionREADME
satteri-expressive-codeHAST plugin: render code blocks with Expressive CodeSatteri Expressive Code npm VersionREADME
vite-plugin-satteriVite plugin: import .md and .mdx filesvite-plugin-satteri npm VersionREADME

Acknowledgements

Sätteri builds on the work and knowledge of several open-source projects:

  • unifiedjs -- the ecosystem of tools for processing content with syntax trees, including remark and rehype
  • pulldown-cmark -- CommonMark pull parser
  • mdxjs-rs -- MDX compiler by Titus Wormer, forked to use pulldown-cmark and OXC

Special thanks to the following projects for paving the way for high-performance Rust <-> JavaScript interop:

  • oxc -- Rust JavaScript parser and compiler by the OXC team, used for MDX compilation
  • Lightning CSS -- Rust CSS parser with a optimized JavaScript Visitor API

Sätteri is an open-source project born from Bruits, a Rust-focused collective 💛