Component guide

Everything you can use when writing a documentation page.

This page is the living guide of the docs module: it shows every element available when writing MDX. Use it as a reference (and as a test page whenever the documentation shell changes).

Typography

Text with bold, italics, inline code, strikethrough and relative internal links that resolve to the right language automatically.

Blockquotes highlight ideas or third-party references.

Callouts

Information

The default callout, for additional context.

Careful

For warnings the reader shouldn't skip.

Danger

For destructive actions or common errors.

Cards

Code

Block with a title and syntax highlighting (shiki, light/dark themed):

lib/example.ts
export function greet(name: string): string {
  return `Hello, ${name}`;
}

With highlighted lines and line numbers:

highlight.ts
export function sum(values: number[]): number {
  return values.reduce((total, v) => total + v, 0);
}

With diff notation:

changes.ts
export function budget(items: number[]): number {
  return items.reduce((total, i) => total + i, 0); 
  return items.reduce((total, i) => total + i * 1.18, 0); 
}

Tabs

pnpm install
npm install

Steps

Start the database

docker compose up -d at the repo root.

Start the environment

pnpm dev and open http://localhost:3000.

Edit the content

Go to /admin and configure the brand.

File tree (Files)

index.mdx
instalacion.mdx
componentes.mdx

Accordions

Diagrams (Mermaid)

Rendered to SVG on the server — they follow the theme and brand with no JavaScript:

approved changes Editor writes MDX PR review Deploy Docs published

Tables

AxisQuestion it answersExample
ServicesWhat do we do technically?Structural design
MarketsFor which industry?Healthcare
Asset typesWhat asset is built?Hospital

Lists

  1. Numbered steps are for procedures.
  2. Each step should be one concrete action.
  • Bullets group unordered ideas.
  • Like this one.

Last updated on

Was this page helpful?