Skip to content

mvahaste/meridian

ย 
ย 

Repository files navigation

๐Ÿ•ฏ๏ธ Meridian

A sleek and minimal theme for Obsidian.

Meridian Theme Screenshot

๐Ÿ“‘ Table of Contents

๐Ÿš€ Quickstart

๐Ÿ“ฆ Community Themes

  1. Go to Settings โ†’ Appearance โ†’ Themes โ†’ Manage.
  2. Search for Meridian in the community themes list.
  3. Select Install and use.
  4. (Optional) Install the Style Settings plugin to access customization options.

๐Ÿ› ๏ธ Manual Installation

Clone this repository into your .obsidian/themes directory, or:

  1. Download the theme.css and manifest.json files from the latest release.
  2. Place them into a new folder named Meridian inside your .obsidian/themes directory.
  3. Enable the theme in Settings โ†’ Appearance โ†’ Themes (you might need to restart Obsidian).
  4. (Optional) Install the Style Settings plugin to access customization options.

โœจ Features

Important

This is a macOS-focused theme.
It should also work on Windows (blur not supported), but support for other platforms is not guaranteed.

๐Ÿงผ Minimal & Uncluttered UI

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.

๐Ÿ“š Per-Note Visual Customization

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.

โš™๏ธ Configurable Settings

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.

๐Ÿ› Issues & Feature Requests

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.

๐Ÿ›  Development Guide

  1. Fork or clone this repository.
  2. Create a .env file in the root directory of the repository with .env.example as a template.
  3. Run npm install to install all dependencies
  4. Run npm start to compile the theme into your Obsidian themes directory and watch for changes.

โค๏ธ Acknowledgements

๐Ÿ“„ License

This theme is distributed under the MIT License.

About

๐Ÿ•ฏ๏ธ A sleek and minimal theme for Obsidian.

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • CSS 94.3%
  • JavaScript 5.7%