Skip to content

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

Prose
Make a reading page from my notes with headings, callouts and footnotes.
Images
Add my images with alt text and captions.
Media
Add my video with captions and a transcript, and my audio recording.
Charts
Add a CSV chart and stat row from the numbers I provide.
Layout
Group alternate instructions in tabs, comparisons in columns/cards and optional context in details.
Tables
Add a sortable comparison table; keep numbers numeric.
Code
Add named code fences, a Mermaid diagram with accessible title and the math I provide.
Cms
Show the authorized collection as a live table, field, total and boolean toggle. Ask which collection I authorize.
Forms
Add an autosaving feedback form, with a required rating and optional comment.
Listen
Prepare the page for Listen: clear headings, labels and readable media transcripts.
Edit
Publish source I can edit in Page mode, retaining the same artifact for revisions.
Export
Check Word and PDF export, including readable static fallbacks for live data.

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

BlockAttributes (quoted values)
videosrc, poster, captions, title, ratio
markdown
::video[Demo]{src="demo.mp4" captions="en.vtt"}

audio

BlockAttributes (quoted values)
audiosrc, poster, captions, title, ratio
markdown
::audio[Recording]{src="voice.mp3"}

stat

BlockAttributes (quoted values)
statvalue, change, trend, note
markdown
::stat[Revenue: 42]{value="42"}

chart

BlockAttributes (quoted values)
charttype, title, x, y, labels, unit, format
markdown
:::chart{type="bar" title="Count"}
```csv
month,count
Jan,4
```
:::

columns

BlockAttributes (quoted values)
columnsNone
markdown
:::columns
::::card[Decision]
Keep the plan.
::::
:::

card

BlockAttributes (quoted values)
cardNone
markdown
:::card[Decision]
Keep the plan.
:::

tabs

BlockAttributes (quoted values)
tabsNone
markdown
:::tabs
::::tab[Read]
Read the guide.
::::
:::

tab

BlockAttributes (quoted values)
tabNone
markdown
::::tab[Read]
Read the guide.
::::

details

BlockAttributes (quoted values)
detailsNone
markdown
:::details[Context]
More detail.
:::

sortable

BlockAttributes (quoted values)
sortableNone
markdown
:::sortable
| Name | Count |
| --- | ---: |
| Oak | 4 |
:::

data-table

BlockAttributes (quoted values)
data-tablecollection, dataset, fields, audience, where, sort, limit, editable
markdown
::data-table[Tasks]{collection="tasks" fields="title"}

form

BlockAttributes (quoted values)
formdataset
markdown
:::form[Name]{dataset="answers"}
::field-text[Name]{name="name"}
________
:::

answers

BlockAttributes (quoted values)
answersfields
markdown
::answers[Your answers]{fields="name"}

data-field

BlockAttributes (quoted values)
data-fieldcollection, entry, field, editable
markdown
::data-field[Title]{collection="tasks" entry="123e4567-e89b-42d3-a456-426614174000" field="title"}

data-stat

BlockAttributes (quoted values)
data-statcollection, fn, field, where
markdown
::data-stat[Tasks]{collection="tasks" fn="count"}

data-toggle

BlockAttributes (quoted values)
data-togglecollection, entry, field, editable
markdown
::data-toggle[Done]{collection="tasks" entry="123e4567-e89b-42d3-a456-426614174000" field="done"}

Reading, editing and exports

TopicBehaviour
The contents pill appears from two matchThe 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.
EditingIn 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.
ExportsSave 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

TopicBehaviour
CMS accessCMS 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.
LimitsCharts: 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.