A sleek and minimal theme for Obsidian.
- ๐ Quickstart
- โจ Features
- ๐ Issues & Feature Requests
- ๐ Development Guide
- โค๏ธ Acknowledgements
- ๐ License
- Go to Settings โ Appearance โ Themes โ Manage.
- Search for Meridian in the community themes list.
- Select Install and use.
- (Optional) Install the Style Settings plugin to access customization options.
Clone this repository into your .obsidian/themes directory, or:
- Download the
theme.cssandmanifest.jsonfiles from the latest release. - Place them into a new folder named
Meridianinside your.obsidian/themesdirectory. - Enable the theme in Settings โ Appearance โ Themes (you might need to restart Obsidian).
- (Optional) Install the Style Settings plugin to access customization options.
Important
This is a macOS-focused theme.
It should also work on Windows (blur not supported), but support for other platforms is not guaranteed.
Hides visual noise and distractions across the interface.
- Sidebar toggle buttons, nav headers, tab headers, and other UI chrome are hidden unless hovered or focused.
- Tab bar dynamically hides when only a single tab is open.
- Status bar, backlinks, and file metadata are grayed and semi-transparent until hovered or focused.
- Optional always-hidden mode for the tab bar.
- Sidebar headers (tags, backlinks, outline, etc.) and graph controls are only visible on hover.
- Scrollbars, tooltips, flair, and instruction text are removed or minimized where possible.
- Improves spacing between headers and paragraphs for cleaner readability.
Use the cssclasses frontmatter property to apply scoped styles per note.
- Invert, grayscale, sepia, or blur imagesโwith effects removed on hover.
- Align images or text left, right, center, or justify.
- Scale images smoothly on hover.
- Transform text to uppercase, lowercase, or capitalized.
- Switch text to monospace or apply specific font weights (thin to black).
๐ก Tip: Create a note with all available styles applied to enable suggestions.
Tailor the theme's appearance and behavior through various toggles and sliders via the Style Settings plugin.
- Background Opacity โ Adjust the transparency of the background mask (0โ1).
- Minimal Image Captions โ Toggle a cleaner, low-profile style for image captions (requires the Image Captions plugin).
- Show Header Levels โ Choose to always display header levels or only on hover in preview mode.
- Show Header Hashtags โ Optionally show
#before headers in preview mode. - Hide Header Link Underline โ Remove underlines from linked headers for a sleeker look.
- Hide Tab Bar โ Choose between dynamically hiding the tab bar, always hiding it, or never hiding it.
- De-emphasize UI Elements โ Soften visual prominence of the status bar, file properties, and embedded backlinks in preview mode.
Meridian is a personal project, but I welcome contributions and feedback. I'll do my best to address issues and feature requests as time allows.
- Fork or clone this repository.
- Create a
.envfile in the root directory of the repository with.env.exampleas a template. - Run
npm installto install all dependencies - Run
npm startto compile the theme into your Obsidian themes directory and watch for changes.
- Forked from the Apex theme.
- Configurable via the Style Settings plugin.
This theme is distributed under the MIT License.
