Media

Images today

Use standard Markdown images with a relative path or absolute URL:

![Sequence diagram](../assets/sequence.png)

![Logo](https://cdn.example.com/logo.svg)

Keep binaries in the repo under an assets/ folder (or host on a CDN). Exact binary handling depends on your git sync path and provider.

Videos, PDFs, diagrams

Coming soon — First-class embeds for video, PDF viewers, and diagram syntax (for example Mermaid) with themed rendering.

Workaround: link out to hosted media, or embed via absolute URLs where your content allows.

Logos and favicon

Set absolute URLs in theme (site.yaml):

theme:
  logo_url: https://cdn.example.com/logo-light.svg
  logo_dark_url: https://cdn.example.com/logo-dark.svg
  favicon_url: https://cdn.example.com/favicon.ico

The shell uses logo_dark_url in dark mode when set. See Theme.

Related

• Project structure

• Markdown