README file from
GithubOpendian

A developer-documentation theme for Obsidian. Monospace typography, a layered radius system, and minimal chrome — inspired by the OpenCode visual language. Makes your vault feel like a professional code editor, not a note-taking app.
中文介绍 · Light & Dark · Desktop & Mobile · No plugin required
Why Opendian
- Monospace-first typography — IBM Plex Mono → Berkeley Mono → JetBrains Mono across headings, body, and UI. Your vault reads like terminal output and technical documentation.
- Layered radius system — content stays sharp (0px for code blocks, tables, callouts), controls are soft (4–8px for buttons, inputs, tabs), modals are softer (12px). One coherent principle instead of random roundness.
- Minimal-lines chrome — hard 1px borders are replaced by background-step separation. The tab bar, titlebar, and view header blend into one immersive surface.
- OpenCode color system — precise tokens derived from the OpenCode website and desktop client.
#007AFFaccent, monochrome primary actions, semantic callout colors. - Flat active tab — inactive tabs are plain text with hairline dividers; the active tab is a quiet tinted chip that stays aligned with the native side docks.
- Terminal-grade code blocks — softly-filled surface with language labels. No fake macOS window dots, no copy-button chrome, no drop shadows.
- Semantic callouts — left accent bar + tinted background, matching OpenCode's documentation aside style. Distinct palettes for info, warning, success, and danger.
- IDE-style sidebar — black accent bar on the active file, auto-collapsing top toolbar (Folio-style), and a dual-tone vault wordmark.
Design
Opendian is built on the OpenCode color system — a precise, monochrome-forward palette with a single blue accent:
Light mode (Docs Style):
| Token | Value | Use |
|---|---|---|
| Background | #FFFFFF |
Primary writing surface |
| Surface | #F5F5F7 |
Sidebar, inactive tabs, secondary areas |
| Border | #D2D2D7 |
Dividers, 1px lines |
| Text Main | #1D1D1F |
Body text and headings |
| Accent | #007AFF |
Links |
Dark mode (Terminal Style):
| Token | Value | Use |
|---|---|---|
| Background | #0C0C0E |
Primary surface |
| Surface | #161618 |
Sidebar, inactive tabs |
| Border | #38383A |
Dividers |
| Text Main | #FFFFFF |
Body text |
| Accent | #007AFF |
Links |
Typography uses a monospace-first stack with CJK fallbacks:
- Headings and body: IBM Plex Mono, Berkeley Mono, JetBrains Mono, SF Mono → Source Han Sans SC
- Interface: Same mono stack → PingFang SC
- Code: Same mono stack (no fallback needed)
Radius Scale
| Tier | Value | Applies to |
|---|---|---|
| Content | 0px |
Code blocks, tables, callouts, blockquotes |
| Small chip | 4px |
Tags, menu items, suggestion rows |
| Control | 6px |
Buttons, inputs, dropdowns, tabs |
| Popover | 8px |
Right-click menu, command palette, tooltips |
| Modal | 12px |
Settings window and dialogs |
What Opendian Styles
Opendian covers every surface that shapes the developer writing experience:
- Code blocks — softly-filled surface with language-label header; no decorative dots, copy-button chrome, or shadows
- Inline code — borderless tint + accent-colored text
- Callouts — left 3px accent bar + 8–10% opacity tinted background, matching OpenCode docs
- Tables — minimalist 1px horizontal hairline rows, zero radius, compact density
- Blockquotes — single neutral bar, no accent color bleed
- Headings — monospace, no decorative underlines, edit-reading size parity
- Tabs — immersive bar with a flat active chip, hairline dividers, and a geometric pinned-tab marker
- Sidebar — black accent bar on active file, auto-collapsing top toolbar
- Vault wordmark — dual-tone text treatment without a hard-coded avatar box
- Buttons — solid black/white primary CTA, outline secondary, 6px radius
- Toggles — rounded rectangle (5px track, 3px knob), not a pill
- Checkboxes — monochrome fill, no strikethrough on done tasks (fade only)
- Dropdowns — borderless with
field-sizing: contentfor value-width sizing
Installation
Install from the Obsidian community theme browser:
- Open Settings → Appearance → Themes → Manage
- Search for Opendian
- Install and enable the theme
Manual installation is also possible by downloading the latest release and placing theme.css and manifest.json in:
<vault>/.obsidian/themes/Opendian/
Compatibility
- Obsidian 1.4.0+
- Light and dark modes
- Desktop and mobile
- No plugin required
