---

Key Features • Screenshots • Getting Started • Plugin Support • Snippets • Documentation • Roadmap • Contributing • Contact • Acknowledgments • License

---

✨ Key Features

Independent Light and Dark theme Options

• Accent Style and Accent Colour Customisation. Choose between 5 Accent Styles and 10 preset Accent Colours ( You can also select a custom colour!).
• Highlight System based on the <mark> tag. 10 preset colours available and 5 different styles.
• Ability to change the background to a different solid colour or an image of your choosing.
• Custom background options for the Kanban boards.

UI Features

• Position and Alignment options for the Titlebar, Status Bar and Sidebar elements.
• Custom Titlebar Style to fit the look of Windows 10/11 Titlebars.
• Interface wide Border Radius and Window Gap Adjustments.
• Vertical Lines (Relationship lines) for the File Explorer and an ability to wrap long file/folder names.
• Custom Vault Banner which replaces the Vault Title in the File Explorer with a banner. You can customise the icon next to the title to what you want in the Style Settings.
• Ability to add Scrollbar buttons and enlarge the scrollbar when hovering over scrollable content.

... and many more handy options for you to explore!

📸 Screenshots

🚀 Getting Started

Install the Prism Theme

Recommended Method - Built-in Install

1. Open Obsidian and go to Settings.
2. Click on the Appearance tab.
3. Click the Manage button.
4. In the Filter... Search Box under the Community Themes section search for Prism.
5. Click the Use button.

Alternative Method - Manual Install

1. Manually download the obsidian.css theme file.
2. Open Obsidian and go to Settings.
3. Click on the Appearance tab.
4. Under the Themes section click on the Folder Icon next to the Manage button.
5. Paste the Theme file into the newly opened folder.
6. Make sure to rename the obsidian.css file to Prism.css.

Required Plugin/s

This theme requires the Style Settings plugin to function correctly and to access various theme specific settings.

Install the Style Settings Plugin

1. Open Obsidian and go to Settings.
2. Click on the Community plugins tab.
3. Under the Community plugins section, click on the Browse button.
4. In the Search community plugins... Search Box look for Style Settings.
5. Click the Install button.

Enable the Style Settings Plugin

1. Open Obsidian and go to Settings.
2. Click on the Community plugins tab.
3. Under the Installed Plugins section look for Style Settings.
4. Click the Toggle next to Style Settings to On.
5. You should now see Style Settings tab show up in the Left Sidebar in the Settings under the Plugin Options section.

I highly recommend for you to go through the options available in the Style Settings to make the theme fit you just right!

🔌 Plugin Support

Required for the Theme to work correctly and to enable customisation:

Style Settings - Allows snippet, theme, and plugin CSS files to define a set of configuration options.

Explicitly supported by the theme:

• Advanced Tables - Add improved navigation, formatting, and manipulation to markdown tables in Obsidian.

• Kanban - Create markdown-backed Kanban boards in Obsidian.

• Collapse All - Adds a button to close or open all folders in the File Explorer.

• Quick Explorer - Menu-based and keyboard-friendly Explorer in the Titlebar.

• Calendar - Creates a simple Calendar view for visualizing and navigating between your daily notes.

• cMenu - Adds a minimal and user friendly text editor modal for a smoother writing/editing experience.

• Dangling Links - Displays the set of dangling links in your current vault in a side-panel.

• Pane Relief - Adds per-pane navigation history to Obsidian.md.

• Sliding Panes - Changes the way panes in the main workspace are handled. Inspired by the UI of Andy Matuschak's notes.

...and more! Checkout the full list in the Plugins Supported section of the Wiki.

(These plugins have been checked to work correctly and might have additional settings in Style Settings)

If you have any issues with the plugins mentioned above or would like another plugin to be supported by the theme Submit an Issue regarding it.

✂️ Snippets

Theme features which you can import as snippets into Obsidian are located in the Snippets Folder. These features have been requested by users for use in other themes and for additional interoperability between themes. If you would like to see a feature of Prism as a snippet make a Feature Request in the Issues section of this repo.

📖 Documentation

The theme has a fully encompassing Wiki, which includes additional detailed descriptions with images/GIFs of all Style Settings Options for Prism. This can be found in the Wiki Section of this Repository.

🗺 Roadmap

Planned task in a rough order of priority:

• General code cleanup and polish of the core Obsidian UI theme.
• Full commenting of the source code for easier development.
• Documentation/Frequently Asked Questions section to help guide new theme users.
• More explicitly supported plugins.
• Custom-made UI Icons.
• Mobile support.

See the Open Issues for a full list of proposed features and known issues.

🛠 Contributing

Currently the theme is being designed for desktop use with mobile planned once the desktop theme is in a good place. The theme has been tested on Windows 10/11 so there might be some issues on Linux/MacOS.

If you want to provide specific feedback or report an issue please use Issues.

Although I don't prohibit pull requests, the theme is quite complex with a lot of intricate details to keep in mind when adding features so unless you have a good understanding of how themes that utilise Style Settings work and familiarised yourself with how this theme is setup, I'd recommend submitting an Issues instead. I'll try my best to stay on top of the most pressing issues/feature requests!

Otherwise you are welcome to contact me through the channels mentioned below to discuss anything regarding the theme.

📬 Contact

If you have any questions you can message me on Twitter and Discord:

Feel free to reach out to me via the Official Obsidian Discord Channel:

📣 Acknowledgments

• Thanks to the developers of Obsidian.md (@ericaxu and @Lishid) for providing an amazing tool free of charge!
• Special shoutout to @mgmeyers for Style Settings and Kanban Plugins that are the backbone of this theme! Also thank you for addressing some issues I've encountered with Style Settings while developing the theme.
• Huge thanks to the Obsidian Community over at Discord for endless inspiration to improve the theme!
• Thanks to @kepano and Minimal Theme for figuring out the Sass/SCSS workflow using Grunt which I based my workflow on for Prism.

📝 License

Distributed under the MIT License. See LICENCE for more information.