Skip to main content

MDX & the component library

A document can be plain Markdown or MDX — Markdown plus rich, reusable components. MDX lets you drop callouts, columns, live card chips, and your own workspace components into a page.

Converting to MDX​

An existing Markdown document can be converted to MDX with a single action in the editor. Conversion is one-way — once a document is MDX, it stays MDX.

Built-in components​

While editing MDX, use the insert-component menu to add any of the built-in components:

  • Callout — highlight a note or warning.
  • Columns — lay content out side by side.
  • Card and Badge — styled content blocks and labels.
  • Stat — show a headline number.
  • Details — a collapsible section.
  • Checklist — a list of check items.
  • TrelloCard — a live card chip that stays in sync with the real card.
  • CanvasLink — link to a canvas.

Workspace components​

Beyond the built-ins, your workspace can define its own reusable components in a component library. Each component has:

  • a name documents reference it by,
  • a template describing what it renders, and
  • typed props that callers fill in.

Once a component exists, any MDX document in the workspace can use it by name — so shared patterns stay consistent across your team's pages.

Safe by design​

MDX in Cardscape is restricted: it can't run arbitrary code. Documents are checked when you save, so what you save is guaranteed to render.

If a workspace component is later renamed or deleted, older documents that used it don't break — the reference simply degrades to a harmless placeholder chip, and the rest of the document renders as normal.

tip

The AI agent can author workspace components for you, so you don't have to build every template by hand.