![](https://github.com/kepano/obsidian-minimal/raw/master/cover.png) # Overview Minimal is an [open source](https://github.com/kepano/obsidian-minimal) distraction-free theme for [Obsidian](https://obsidian.md/), by [@kepano](https://stephango.com/about). Minimal makes it easy to customize the appearance of Obsidian, to create your ideal writing interface. You can learn more about me on [my personal site](https://stephango.com/about) and also find my [related Obsidian projects](https://stephango.com/obsidian). <a href="https://www.buymeacoffee.com/kepano"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=kepano&button_colour=6a8695&font_colour=ffffff&font_family=Poppins&outline_colour=000000&coffee_colour=FFDD00" width="180px"></a> <a href="https://github.com/kepano/obsidian-minimal"><img src="https://img.shields.io/github/stars/kepano/obsidian-minimal?style=social" style="padding:7px 7px 5px" width="125"></a> # Get started ### 1. Install Minimal theme [Open in Obsidian](obsidian://show-theme?name=Minimal) or follow the steps below: 1. Open Obsidian Settings 2. Go to `Appearance` and click `Manage` 3. Search for **Minimal** and click `Install and use` ### 2. Install the companion plugin [Open in Obsidian](obsidian://show-plugin?id=obsidian-minimal-settings) or follow the steps below: 1. Go to `Community Plugins` and turn off `Safe mode` 2. Search for **Minimal Theme Settings** and click `Install`, then `Enable` ### 3. Install optional related plugins - [[Style Settings]] allows you to create custom [[Color schemes]] and tweak Minimal with more fine-grained control. - [[Hider]] hides UI elements such as window frame, scrollbars, tooltips, etc. # Screenshots Minimal offers multiple options for [[background contrast]] including a true black option ideal for OLED devices. This feature also supports popular [[color schemes]] such as Solarized, Flexoki, Nord, and Gruvbox. ![](https://github.com/kepano/obsidian-minimal/raw/master/assets/minimal-variants.png) [[Helper classes]] for [[tables]] and [[cards]] allow you to create powerful workflows. ![](https://github.com/kepano/obsidian-minimal/raw/master/assets/minimal-movies.png) Combining [[focus mode]] with [[image grids]] and [[block width]] options allows you to immerse yourself in visual projects. ![](https://github.com/kepano/obsidian-minimal/raw/master/assets/minimal-img-grid.png) Minimal includes support for dozens of popular plugins like **Calendar**, **Kanban**, **Dataview**, **Outliner**, **Excalidraw**, and more. ![](https://github.com/kepano/obsidian-minimal/raw/master/assets/minimal-plugins.png) # App-level features - [[Active line highlighting]] - [[Background contrast]] - [[Color schemes]] - [[Colorful frame]] - [[Colorful headings]] - [[E-ink mode]] - [[Focus mode]] - [[Hotkeys]] - [[Image zoom]] - [[Line width]] - [[Match system theme]] - [[Tab styles]] - [[Navigation labels]] # Block-level features - [[Block width]] - [[Helper classes]] - [[Images#Image filters|Image filters]] ### Block types - [[Cards]] - [[Charts]] - [[Checklists]] - [[Embeds]] and transclusions - [[Iframes]] - [[Images]] - [[Image grids]] - [[Maps]] - [[Progress bars]] - [[Tables]] # Plugin support - [[Calendar]] - Checklist - [[Charts plugin]] - [[Dataview]] - Dictionary - Excalidraw - Git - [[Hider]] - Kanban - [[Leaflet]] - [[Obsidian Publish]] - Outliner - [[QuickAdd]] - [[Sortable]] — recommended for [[Cards]] and [[Tables]] - [[Style Settings]] - Zoom # Guides - [[Create a movie database]] - [[macOS configuration|Make Obsidian feel like a native macOS app]] # Troubleshooting Visit the [[Help|Help page]] for troubleshooting. Have a question? Join the [Minimal channel](https://discord.com/channels/686053708261228577/931008597557649410) on the official [Obsidian Discord](https://discord.gg/veuWUTm). # Contributing If you would like add [[Plugin support]], or have found a bug you would like to help fix, don't hesitate to open a pull request. Have a question? Join the [Minimal channel](https://discord.com/channels/686053708261228577/931008597557649410) on the official [Obsidian Discord](https://discord.gg/veuWUTm). - [[Sponsorship]] - [[Local development]] - [[Localization]] - [[Plugin support]] - [[License]] - [[Help]]