.md) file written in Quarto dashboard syntax. The saved file holds the layout, text, and values, so it stays readable outside Qualia. For long-form prose, use a writeup instead.
Create a dashboard
Ask the agent to create one. For example, try “Make a dashboard of this week’s experiment results.” To write one yourself, create a.md file and add format: dashboard to its YAML frontmatter:
Lay out pages, rows, and columns
You set the layout with headings. The frontmattertitle names a standalone dashboard.
#headings create pages, such as# Overview.##headings create rows, such as## Row.###headings divide a row into columns. Deeper headings keep alternating between rows and columns.
{width=60%} to its heading. To start with columns instead of rows, use format: {dashboard: {orientation: columns}}. To show a row’s or column’s cards as tabs, add {.tabset} to its heading; each tab takes its name from a card’s title attribute.
Fill cards
You can put Markdown text, tables, images, and captured Plotly charts in a card.- Embed a figure: Put
[[figure:C-123]]in its own paragraph inside a card.C-123is the ID of a captured figure in Knowledge. - Cite evidence: Add
[[claim:C-123]]after a statement. A claim is a recorded finding or piece of evidence, such as a value captured from a notebook. - Add images: Keep them in a folder beside the dashboard named
[FILENAME].assets/, such asoverview.assets/chart.png.
Value boxes
A::: {.valuebox} block shows its first paragraph as the label, its second as the value, and any remaining paragraphs as context. Write numbers, currency, percentages, and comparisons exactly as they should appear.
Qualia doesn’t calculate dashboard values for you. Ask the agent to compute and verify them in a notebook or script, write them into the file, and cite the evidence. Values stay as saved until you or the agent update the file.
Qualia previews the saved Markdown and captured charts. It doesn’t run Quarto code cells, inline calculations, or Shiny servers.
Edit a dashboard
Click Source at the top right to edit the Markdown, then Preview to see the layout. Save source changes with Cmd/Ctrl+S. The preview updates whenever an agent saves changes.Follow pipeline runs
A pipeline is a saved set of instructions that produces a report or dashboard each time it runs, on demand or on a schedule. See Pipelines to create one. Each run writes its report toreport.md in its own run folder, so you keep every earlier run’s results. To rename a pipeline’s dashboard, rename the pipeline.
- View a run: Select it in the Runs sidebar to see its report and open its agent’s chat, where you can ask about the results.
- Start another run: Click New run.
Share a dashboard
In a cloud workspace, click Share, then Copy beside the link. Only the project owner can choose who may open it:- Project viewers (default): People with view access to the project, after signing in.
- Anyone with the link: Anyone, without signing in.
- Pipeline dashboards keep the same link when you rename the pipeline, and readers can pick earlier runs. You can share a run before it finishes; its report appears when ready.
- Standalone dashboards link to the saved file.

