Skip to content

starlight-theme-mdbook

A Starlight theme that looks and feels like rust-lang’s mdBook (live example, used for The Rust Programming Language book) — layout, chrome, and color schemes — while keeping all of Starlight’s own functionality (content collections, Markdown/MDX, Pagefind search, i18n, sidebar autogeneration, etc.) untouched underneath.

This whole site is built with the theme itself — what you’re looking at right now is starlight-theme-mdbook in action, not a mockup.

  • Color schemes — Light, Dark (mdBook’s Coal), Rust, plus two bonus palettes ported from daisyUI (Valentine, Caramellatte) — selectable from the paintbrush button in the navbar.
  • Layout — a genuine full-height left sidebar, a navbar confined to the content column with mdBook’s exact button layout, and a draggable resize handle on the sidebar’s edge.
  • “On this page” — heading TOC injected directly into the left sidebar under the active chapter link, instead of a separate right-hand column.
  • Chapter navigation — floating / arrow buttons pinned to the viewport edges, with real Left/Right arrow-key navigation.
  • Mobile — a true collapsible sidebar overlay at any screen width, not just Starlight’s default mobile-only behavior.
  • Installation — add the theme to a new or existing Starlight project.
  • Configuration — everything the theme picks up from your normal Starlight config.
  • Themes — a closer look at each of the 5 color schemes.