Customize
Logo and fonts
Put your mark in the navbar, set a favicon, and choose typefaces for prose and code.

Logo
Point at an image in your repository. It replaces the project name in the navbar.
site:
logo: brand/logo.svg
logo_dark: brand/logo-dark.svg # optional
favicon: brand/favicon.svg
Paths are relative to your repository root. DeepDoc copies each file into the
site’s public/ directory at build time, so nothing needs to be hosted
elsewhere.
logo_dark is optional. Give it one and the two are swapped in CSS rather than
JavaScript, so the correct mark is right on first paint with no flash. Omit it
and the same logo is used in both themes.
Point at a file that does not exist and DeepDoc says so and carries on:
site.logo: 'brand/logo.svg' not found — skipping.
Favicon
Same idea — repo-relative, copied into public/, wired into the page metadata
as the browser-tab icon.
Browsers cache favicons aggressively. If you change yours and the tab looks unchanged, hard-reload (⌘⇧R) before assuming it did not work.
Fonts
Fonts are opt-in. Leave them empty — the default — and your docs site makes no external font request at all, using the reader’s system stack.
site:
theme:
fonts:
sans: "Inter"
mono: "JetBrains Mono"
Any Google Fonts family name works; it is passed straight through. Both stacks always keep a real system fallback, so text stays readable if the font fails to load.
Choices that read as clearly not the system default:
| Family | Character |
|---|---|
Inter | Neutral, workhorse UI sans |
Space Grotesk | Geometric, distinctive a and g |
Outfit | Rounded, friendly |
IBM Plex Sans | Slightly technical |
Merriweather | Serif — unmistakably different |
Code theme
Syntax highlighting is separate from the page palette, so you can pair a light page with a dark code block or match them.
site:
theme:
code_theme:
light: github-light
dark: dracula
Any Shiki theme name works. Defaults are
github-light and github-dark.
Repository link
site:
repo_url: "https://github.com/acme/widgets"
This adds the repository icon to the navbar and is what the edit-this-page link is built from.