Style Guide
Reference for the surfaces upstream's stylesheet already paints. MDX
authors get the same look via the ported components (Aside, Card,
Steps, …).
Asides
Note
Use <Aside type="note"> in .mdx — or this raw markup in Markdown.
Tip
type="tip" — rocket icon upstream.
Caution
type="caution".
Danger
type="danger".
Cards
Install
Pin the theme from JSR and activate it.
Configure
Toggle search, pagination, credits, social links.
Steps
- Install from JSR
- Set
sidebar_section(or leave*) - Press CtrlK to open search
Badges
default note success caution danger
Typography
| Element | Example |
|---|---|
| Inline code | sidebar_section |
| Link | Upstream docs |
| Emphasis | italic and bold |
export const sidebarSection = "*";
A plain blockquote — distinct from the coloured asides above.
Theme picker
Use the header control to switch Light / Dark / Auto — upstream
starlight-theme-select, preference in localStorage as starlight-theme.