Reading Books — the paginated layout

Put a whole book in one .md and a scrollbar stops being enough. Rho's book layout turns a long document into pages you turn — read it like an e-reader, pick up where you left off, resize the text without losing your place.

Turning it on

Declare the document a book in its frontmatter:

---
kind: book
---

A kind: book document opens paginated. Any ordinary long document can opt into the layout without joining the bookshelf:

---
layout: book
---

Want a kind: book file back in normal scrolling? Add layout: doc.

Where chapters come from

No extra markup — level-1 headings (#) are chapters. If the file has only one # (usually the title), ## headings become the chapters. Anything before the first chapter heading (title, introduction) is the book's opening page.

The Outline sidebar becomes the table of contents: click any chapter to jump, and the chapter you're reading stays highlighted.

Turning pages

It remembers your place

Close the book, restart the app, come back tomorrow — you land on the page you left. Position is remembered as chapter + position within it, so after a window resize or font change you return to the same text, not the same page number.

Font size and typography

The font-size control (or Ctrl + / Ctrl -) works as usual: bigger text means more pages, but your reading position stays put. The companion theme: book document theme sets warm paper, a serif face and generous leading for long sessions:

---
kind: book
theme: book
---

Interactive content stays alive

Charts, interactive blocks and tables never get torn across a page break; a block taller than the page gets its own page and scrolls internally. Sliders still drag, formulas still compute — it's a Rho book, not a scan.

Editing

Entering edit mode temporarily returns the book to a full scrolling document (auto-scrolled to the chapter you were reading) so you can edit with context; leaving edit mode returns you to your page. Source mode is unaffected.