RSM: Readable Science Markup#

Important

RSM is in active beta. The language is stable and production-ready, but documentation is still evolving. We welcome feedback and bug reports via GitHub Issues.

Publishing with Press: You can now publish RSM manuscripts to Scroll Press, the web-native preprint archive. Press is currently in closed beta—check the website for updates.

What is RSM?#

RSM is a markup language for writing web-first scientific manuscripts. It combines:

  • The simplicity of Markdown

  • The power of semantic tagging

  • Built-in support for citations and cross-references

  • Extensive affordances for interactive figures, videos, algorithms, and mathematical proofs

  • Interactive features like tooltips and handrails for better reading experience

Write once, publish beautifully. RSM manuscripts are responsive, accessible, and designed for modern web reading—not just PDFs.

Quick Start

Why RSM?#

Traditional LaTeX + PDF workflows were designed for printed paper. RSM is designed for pixels:

  • Responsive: Adapts to any screen size

  • Interactive: Click any reference to see a tooltip preview

  • Accessible: Screen reader friendly, high contrast options, custom fonts

  • Structured proofs: First-class support for formal mathematical writing

  • Web-native: HTML output works everywhere, no plugins needed

See Frequently asked questions for detailed comparisons with LaTeX, Markdown, and ReStructuredText.

Tutorials

Writing your first manuscript with RSM and other tutorials.

tutorials.html
Reference manual

Complete reference of every feature and configuration option.

reference.html
Contribution guide

Contribute by reporting a bug or requesting a feature. Get involved by submitting a PR.

contributing.html
FAQ

Frequently asked questions.

faq.html