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:

  1. Declare which spec version you support (v0.5+ / v0.6+ / v1.0+)
  2. Unrecognized DSL blocks show as code-block literals (plain-text fallback — see Plain-text fallback principle)
  3. Encountering unknown modifier ignore (forward compat)
  4. Run the spec's conformance test (planned for v1.0 release — for now, manual spot-check)

See also