Skip to content
Blode.md

AI agents: fetch the documentation index at llms.txt. Markdown versions are available by appending .md to any page URL, including this page's markdown.

Appearance and branding

Configure your logo, favicon, and light/dark mode behavior in docs.json.

Blode.md keeps site branding intentionally narrow. Use logo, favicon, and appearance in docs.json to control the parts of the visual identity that are currently supported. The logo and favicon shapes follow Mintlify's light and dark asset pattern, and Blode.md also accepts logo.alt for accessible text.

Use logo to show a single mark everywhere or separate assets for light and dark mode.

{
  "logo": {
    "light": "/logo/light.svg",
    "dark": "/logo/dark.svg",
    "alt": "Example Co. logo",
    "href": "/"
  }
}
FieldTypeDescriptionRequired
lightstringLogo image path or URL for light mode.Yes
darkstringLogo image path or URL for dark mode.Yes
hrefstringOptional destination when someone clicks the logo. Defaults to your docs homepage.Yes
altstringAccessible alt text for the logo image.Yes

Favicon

Use favicon for the browser tab icon.

{
  "favicon": "/favicon.svg"
}

Appearance

Use appearance to control the initial light or dark mode and whether readers can switch modes.

{
  "appearance": {
    "default": "dark",
    "strict": true
  }
}
FieldTypeDescriptionRequired
default'system' | 'light' | 'dark'Default color mode. Choose `system`, `light`, or `dark`.Yes
strictbooleanWhen `true`, locks the site to the default mode and hides the theme toggle.Yes

Example

{
  "$schema": "https://blode.md/docs.json",
  "name": "Example Docs",
  "slug": "example-docs",
  "logo": {
    "light": "/logo/light.svg",
    "dark": "/logo/dark.svg",
    "alt": "Example Co. logo",
    "href": "/"
  },
  "favicon": "/favicon.svg",
  "appearance": {
    "default": "system"
  },
  "navigation": {
    "groups": [{ "group": "Getting started", "pages": ["index"] }]
  }
}

Blode.md uses its built-in visual system for layout, typography, and component styling. Branding today is about the assets and mode behavior you provide here, not per-site theme tokens.