Documentation capabilities

This section demonstrates what Astro Starlight can deliver for a SaaS documentation site: rich Markdown, built-in UI components, syntax-highlighted code, diagrams, embedded API references, and custom Astro/React elements alongside Telekom ODS chrome.

Markdown & asides

Tables, admonitions, blockquotes, definition lists, and GitHub-flavoured Markdown extras.

Starlight components

Tabs, steps, cards, link cards — layout primitives for tutorials and hubs.

Code & terminals

Expressive Code: titles, diffs, highlights, copy buttons, and shell frames.

Diagrams & assets

Mermaid, FigJam/Excalidraw embeds, Postman collections, and CSV templates.

API reference

Embedded OpenAPI / Swagger docs (Swagger UI) from static specs under public/specs/.

Custom elements

Branded callouts, Supademo tours, and room for ODS React widgets in MDX.

Explore the showcase

Markdown formatting Asides, tables, lists, and semantic structure for long-form guides.

Starlight components Tabs, Steps, Cards — ideal for multi-platform SaaS onboarding.

Code snippets Multi-language examples, diffs, and terminal-style command blocks.

Diagrams & architecture Mermaid, workshop boards, Postman, and downloadable templates.

Embedded API docs OpenAPI 3 and Swagger 2.0 reference embedded with Swagger UI.

Custom components Astro wrappers, third-party embeds, and ODS-friendly patterns.

Production patterns

For large API surfaces, teams often split narrative guides (Starlight) from generated reference (OpenAPI → Swagger UI, Redoc, Scalar, or Stoplight). This PoC shows both in-page embed and link-out options.