Plugins
Sidemark ships as a core review model plus a set of plugins for different host environments. This section collects the publishable integrations in one place so rendering pipelines and interactive editors are easier to compare.
Rendering Plugins
Use these when you want MRSF comments rendered into HTML output.
| Plugin | Package | Best fit |
|---|---|---|
| markdown-it | @mrsf/markdown-it-mrsf | VitePress, markdown-it apps, static HTML rendering |
| rehype | @mrsf/rehype-mrsf | unified, MDX, Astro, Docusaurus, rehype pipelines |
| Marked | `@mrsf/marked) | Marked-based renderers and browser markdown previews |
| Marp | @mrsf/marp-mrsf | Marpit and Marp presentation rendering |
All rendering plugins share the same controller vocabulary, CSS model, gutter behavior, inline highlight semantics, and mrsf:* event model as closely as the host renderer allows.
Editor Plugins
Use these when you want comments inside a live editing surface.
| Plugin | Package | Best fit |
|---|---|---|
| Monaco | @mrsf/monaco-mrsf | Custom Monaco-based apps and editor portals |
| Milkdown + Crepe | @mrsf/milkdown-mrsf | Browser editors using Milkdown directly or Crepe on top |
| Tiptap | @mrsf/tiptap-mrsf | Experimental rich-text editor integration on Tiptap |
Choosing a Plugin
Choose based on where comments need to appear:
- Use a rendering plugin when your host already renders Markdown to HTML and you want badges, highlights, and tooltips in the output.
- Use an editor plugin when your host owns a live editing surface and needs comment state, overlays, and host-controlled persistence.
- Use the VS Code extension when you want a ready-made desktop workflow instead of embedding Sidemark in your own host.
- Use Sidemark for Obsidian when you want a community-maintained review workflow inside your Obsidian vault.
Community Integrations
These integrations are maintained independently of the core packages above. Their own documentation and issue trackers are the best place for installation details and support.
| Integration | Maintainer | Best fit |
|---|---|---|
| Sidemark for Obsidian | Adam Coddington | Comments, threads, and suggested edits in Obsidian notes, stored in MRSF sidecars |
Community integrations share the MRSF format but may add their own behavior and extension fields. See each integration's page for interoperability notes.
Common Model
The core rendering and editor packages above share these conventions:
- sidecar comments remain outside the Markdown source
- canonical anchors are line, range, column, and
selected_text - host applications own persistence and save flows
- interactive integrations emit
mrsf:*events or controller actions instead of hard-coding storage
