# Overview
Minimal is an [open source](https://github.com/kepano/obsidian-minimal) distraction-free theme for [Obsidian](https://obsidian.md/), by [@kepano](https://twitter.com/kepano). Minimal makes it easy to customize the appearance of Obsidian, to create your ideal thought processing environment.
Support development on [Buy me a coffee](https://www.buymeacoffee.com/kepano) and [Twitter](https://twitter.com/kepano)
<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, Nord, and Gruvbox.
[[Helper classes]] for [[tables]] and [[cards]] allow you to create powerful workflows.
Combining [[focus mode]] with [[image grids]] and [[block width]] options allows you to immerse yourself in visual projects.
Minimal includes support for dozens of popular plugins like **Calendar**, **Kanban**, **Dataview**, **Outliner**, **Excalidraw**, and more.
# 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]]
- 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]]