Spec: Written ahead of the package. Not in 7.0.0-alpha.0: pageMarkdown7.0.0-alpha.0
Markdown
A page as Markdown, for an agent that reads text: every heading, line, list, table and code window of the record, in page order.
pageMarkdown(page) returns a Page record as one Markdown string, in the order the sections render. It reads the record, not the HTML, so nothing the Theme draws reaches the text.
What it returns
Each Section type writes the Markdown form of its own fields:
| Section type | Writes |
|---|---|
hero | The title as #, the lede as a paragraph, each action as a link |
| Any section head | Its title as ## and its lede; the eyebrow is dropped |
feature-grid, feature-split, steps | A list: each item's title in bold, then its text |
pricing, plan-table, compare, facts | A table |
faq | Each question as ###, its answer as a paragraph |
terminal, api-call, command-row, agent-prompt | A fence, with its language |
endpoints | A table of method, path and text |
nav, footer | A list of links, once |
article | Its body, as written |
Harbor's pricing section, as specified:
## Priced by the call.
| Plan | Price | Includes |
| --- | --- | --- |
| Deck | $0 a month | 1,000 calls a month · Every berth · Fourteen days ahead |
| Bridge (Most chosen) | $49 a month | 50,000 calls a month · Draft windows · Webhook alerts |
| Harbor | $490 a month | 1,000,000 calls a month · Every Bridge feature · A named harbor master |Status
The .md twin of every docs page, such as /docs/components/site.md, is a feature of this docs site. It is built from the page's own MDX source, not by pageMarkdown. Markdown and JSON twins covers it.