Rho format spec
The complete specification document for Rho format — precise definitions for implementers (not for writers / integrators).
Full specification
→ AINP protocol (v0.9) — hosted here on rho.md, the whole document on one page
Covers:
- The markdown carrier and its static blocks (callout, card layout, timeline, annotate, STL, mermaid)
- The syntax of every interactive block:
chart,interact, direct manipulation (:drag,pick),image, tabs / stepper / modal,table/media/quiz/branch,graph - Text alternatives for charts and interactive figures (
alt =/summary =) - Composition, namespaces and shared state
- An authoring guide: decision tree, patterns, anti-patterns, rules for LLM authors
- The safety model, failure behaviour, fallback in other readers, conformance levels
- The expression mini-language (full grammar and built-in functions) and a one-page cheat sheet
License: the spec is CC BY 4.0 — anyone can implement a reader from it (no commercial license required).
Version history
| Version | Released | Major changes |
|---|---|---|
| v0.0 | 2026-01-15 | Initial: 5 static + 7 interactive = 12 capabilities |
| v0.1 | 2026-01-28 | Spec formalization, HTML output standardization |
| v0.2 | 2026-02-10 | namespace shared state |
| v0.3 | 2026-02-25 | nested DSL inner processor |
| v0.4 | 2026-03-15 | computed derived values |
| v0.5 | 2026-04-22 | timer auto-play animation |
| v0.6 | 2026-05-08 | SVG scenes |
| v0.7 | 2026-06-14 | table / media / quiz / branch |
| v0.8 | 2026-08-03 | graph network / starmap block |
| v0.9 | 2026-09-20 | alt = / summary = text alternatives for charts and interactive figures (current) |
Versions
The specification is pre-1.0: a new version may still change how an existing capability behaves. Say which version your reader supports (below), and check the version history when you update.
Compatibility recommendations for reader implementations
If you build your own reader implementation:
- Declare which spec version you support (
v0.5+/v0.6+/v1.0+) - Unrecognized DSL blocks show as code-block literals (plain-text fallback — see Plain-text fallback principle)
- Encountering unknown modifier ignore (forward compat)
- Run the spec's conformance test (planned for v1.0 release — for now, manual spot-check)
See also
- Implementing your own reader — Walkthrough for building a reader from the spec
- Writer's Guide — Capabilities from "how to use" angle
- AINP protocol (v0.9) — the full text, on this site