MAC Obsidian Theme
Overview
MAC Obsidian Theme is intended to become the visual Obsidian-side companion to MAC Docusaurus.
Its job is simple:
- make the vault feel closer to the published MAC Docs site
- reduce visual friction between writing in Obsidian and publishing through Docusaurus
- keep visual concerns in the theme, not in the plugin
Current Status
Right now, MAC Obsidian Theme is not the active theme used in this vault.
The current live Obsidian setup is:
- theme:
AnuPpuccin - plugin:
obsidian-style-settings - snippet:
extended-colorschemes
There is still a local theme folder in this vault:
.obsidian/themes/MAC Obsidian Theme/
but it should currently be treated as a paused local skeleton, not as a finished or trusted theme.
Why It Exists
This repository is written as an Obsidian-style vault first and published as a Docusaurus site second.
Because of that, the local Obsidian experience matters. A future MAC Obsidian Theme would make the vault feel more like the same documentation system instead of a completely separate environment.
What A Future Theme Should Own
The theme should own the visual layer only:
- colors and surfaces
- typography
- code styling
kbd, tables, details, and blockquotes- callout styling
- pane, modal, and chrome styling where CSS is enough
Anything that requires parsing, rendering logic, or preview transformation belongs in MAC Obsidian Plugin, not in the theme.
Planned Direction
When theme work resumes, the right starting point is not a blank-slate redesign.
The right starting point is:
- keep using the current working Obsidian setup as the stability baseline
- extract the stable visual decisions from
mac-docusaurus - port those decisions into a dedicated Obsidian theme carefully
- bundle any needed icons and assets locally with the theme instead of relying on Docusaurus asset paths
The main things worth matching from mac-docusaurus are:
- accent and surface tokens
- text hierarchy
- radii and spacing
- code block and inline code treatment
kbd- callout structure
- details/summary styling
Constraints
MAC Obsidian Theme should not try to turn Obsidian into a browser copy of the site.
It should improve:
- local readability
- visual consistency
- documentation-heavy note browsing
without making the vault more fragile or harder to maintain.
Relationship To Other MAC Docs Products
- MAC Docusaurus is the active site-side build and theme layer
MAC Obsidian Themeis the planned Obsidian-side visual layer- MAC Obsidian Plugin is the planned Obsidian-side behavior layer
The long-term goal is one canonical vault with two good environments:
- Obsidian for authoring
- Docusaurus for publishing