Markdown template
Build reading pages with rich blocks, live data and forms.
reference~8 minVerified v0.260.0
What you can make
markdown-viewer turns one Markdown source into a reading page. Use prose, images,
video/audio, charts, stats, tabs, columns, details, sortable tables, code, Mermaid diagrams,
math, live CMS values and forms in the same document. The user chooses the template:
use slideshow for a deck and kpi-board for a dashboard when those are requested.
Needs
A connected agent at superartifacts.app/mcp, your source and permission to publish.
Owners/Editors edit source. CMS blocks need authorized collection grants; forms derive
their response policy from the Markdown. Read forms before collecting personal data.
Prompts
Block catalog
Quote every attribute value. Leaf blocks start with ::; containers use ::: and
close with the same colon count. Nested containers need more colons than their parent.
Ordinary Markdown remains the fallback. Unknown attributes show a visible reason.
The machine catalog is the complete agent reference.
It includes a working example for each block and the default and limit for every option.
video
| Block | Attributes (quoted values) |
|---|---|
video | src, poster, captions, title, ratio |
::video[Demo]{src="demo.mp4" captions="en.vtt"}audio
| Block | Attributes (quoted values) |
|---|---|
audio | src, poster, captions, title, ratio |
::audio[Recording]{src="voice.mp3"}stat
| Block | Attributes (quoted values) |
|---|---|
stat | value, change, trend, note |
::stat[Revenue: 42]{value="42"}chart
| Block | Attributes (quoted values) |
|---|---|
chart | type, title, x, y, labels, unit, format |
:::chart{type="bar" title="Count"}
```csv
month,count
Jan,4
```
:::columns
| Block | Attributes (quoted values) |
|---|---|
columns | None |
:::columns
::::card[Decision]
Keep the plan.
::::
:::card
| Block | Attributes (quoted values) |
|---|---|
card | None |
:::card[Decision]
Keep the plan.
:::tabs
| Block | Attributes (quoted values) |
|---|---|
tabs | None |
:::tabs
::::tab[Read]
Read the guide.
::::
:::tab
| Block | Attributes (quoted values) |
|---|---|
tab | None |
::::tab[Read]
Read the guide.
::::details
| Block | Attributes (quoted values) |
|---|---|
details | None |
:::details[Context]
More detail.
:::sortable
| Block | Attributes (quoted values) |
|---|---|
sortable | None |
:::sortable | Name | Count | | --- | ---: | | Oak | 4 | :::
data-table
| Block | Attributes (quoted values) |
|---|---|
data-table | collection, dataset, fields, audience, where, sort, limit, editable |
::data-table[Tasks]{collection="tasks" fields="title"}form
| Block | Attributes (quoted values) |
|---|---|
form | dataset |
:::form[Name]{dataset="answers"} ::field-text[Name]{name="name"} ________ :::
answers
| Block | Attributes (quoted values) |
|---|---|
answers | fields |
::answers[Your answers]{fields="name"}data-field
| Block | Attributes (quoted values) |
|---|---|
data-field | collection, entry, field, editable |
::data-field[Title]{collection="tasks" entry="123e4567-e89b-42d3-a456-426614174000" field="title"}data-stat
| Block | Attributes (quoted values) |
|---|---|
data-stat | collection, fn, field, where |
::data-stat[Tasks]{collection="tasks" fn="count"}data-toggle
| Block | Attributes (quoted values) |
|---|---|
data-toggle | collection, entry, field, editable |
::data-toggle[Done]{collection="tasks" entry="123e4567-e89b-42d3-a456-426614174000" field="done"}Reading, editing and exports
| Topic | Behaviour |
|---|---|
| The contents pill appears from two match | The contents pill appears from two matching headings; toc hides it and tocDepth sets its depth (default 3). Listen below the title uses installed local voices: play/pause, paragraph skips, speed, settings and Close. Backgrounding pauses; editing or printing stops speech. Code, math and diagrams use labels. |
| Editing | In the editor, Page mode edits paragraphs, headings, lists, table cells and code. Done/blur commits; Escape cancels. Unsupported blocks, including forms and CMS bindings, open Edit source. Source Undo does not undo CMS writes. See document editing. |
| Exports | Save before exporting. Word keeps rich blocks, media posters/links and transcripts; unsupported math/diagrams keep source. PDF opens all panels, up to 200 pages. Live CMS exports use authored snapshots; keep private data out of those snapshots. Form exports show blank fields; saved answers stay out. |
Data access and limits
| Topic | Behaviour |
|---|---|
| CMS access | CMS data loads on open or Refresh. Owners/Editors edit when editable="true" and the server grants writes; readers see published masked data read-only. Use authorized policy.collections, never invented grants. Missing access/offline keeps authored fallback; offline CMS edits are not replayed. A source save preserves grants; an empty list clears them. |
| Limits | Charts: 500 rows, eight series, 65,536 CSV bytes; bar, line, area, stacked, pie, donut. Pie/donut require non-negative values; zero totals show an empty chart. CMS: 200 rows/table, 12 fields, 32 bindings and four collections. Aggregates above 1,000 entries are refused. Directives: four nesting levels, 65,536 bytes each. Source: 400,000 characters. Bundle media: 5 MiB/file, 10 MiB total; larger media needs a hosted HTTPS link. Video never autoplays. YouTube/Vimeo remain links. Tiles fetch no media or live data. These document limits differ from form upload limits. |
Check it worked
Open the published page on a phone and desktop. Expand tabs/details, sort a table, play media with captions, try Listen and save an edit. Verify fallback text without CMS access and inspect Word/PDF. If a block fails, check the catalog's quoted attributes; keep readable fallback text while correcting it.