kepano / obsidian-minimal

Find detailed documentation at minimal.guide Minimal is an Obsidian theme for desktop, mobile and tablet. Customize colors, fonts and more with the companion plugins Minimal Theme Settings and Hider. Winner of Obsidian's official Best Theme award ✨ About Minimal• Screenshots• Installation• Companion plugins• Settings• Color schemes• Plugin support• Helper classes• Alternate checkboxes• Hotkeys• Contributing• Developers• License• Disclaimer Screenshots **Background styles** include low contrast, high contrast, and a true black option ideal for OLED devices **Helper classes** for tables and card layouts allow you to create powerful workflows Combining **focus mode** with **image grid** and **image 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 Installation To install the theme• Open Obsidian Settings• Go to and click • Under community themes search for "Minimal" and click To install the companion plugin• Go to and turn off • Under community plugins search for "Minimal Theme Settings" and click , then Have a question? Join the Minimal channel on the official Obsidian Discord. Companion plugins• Minimal Theme Settings plugin allows you to customize color schemes, fonts, hotkeys, and access the main feature toggles. This plugin is highly recommended for all users of Minimal.• Hider plugin is recommended to hide Obsidian UI elements such as window frame, scrollbars, tooltips, etc. When using Hider to turn off the main toolbar (AKA app ribbon), it can be accessed by hovering over the bottom left edge of the window.• Style Settings plugin allows you to create a custom color scheme. This plugin is optional. Settings The following settings can be accessed using Minimal Theme Settings plugin. Many of these settings below can be toggled with hotkeys. Interface colors and fonts• Background contrast — includes true black dark mode for OLED devices• Color scheme — includes Catppuccin, Dracula, Everforest, Gruvbox, macOS, Nord, Solarized, and more• Line width — set normal line width and maximum width within a pane You can also use the Style Settings plugin for even deeper customization Features• Text labels for primary navigation — adds text labels the top left navigation, note that a translation snippet is necessary for languages other than English more on localization• Focus mode — hides title bar and status bar• Colorful frame — use accent color for the top area of the app window• Colorful headings — use different colors for each heading• Hide workspace borders — removes dividing lines for a more minimal appearance• Trim filenames — file names are trimmed to a single line Layout options Controls images, tables and iframes. These settings can also be enabled on a per-file basis using helper classes.• Image grids — turns consecutive images into columns. To make a new row, add an extra line break between images.• Block widths — controls the width of elements by type. Color schemes Preset color schemes Minimal offers color schemes that can be separately selected for light and dark mode using the Minimal Theme Settings plugin. Color schemes include Dracula, Everforest, Gruvbox, macOS, Nord, Notion, Solarized, and Things. Custom color schemes You can use the Style Settings plugin to customize your color scheme. To see your changes more easily, open Style Settings in a new pane by using the command palette ( by default). Using Style Settings you can customize Minimal's colors, font sizes, font styles, and many more details. Plugin support Most plugins work well with Minimal, but the following plugins have received special love and attention:• Calendar• Charts• Checklist• Dataview• Dictionary• Excalidraw• Git• Hider• Kanban• Leaflet for maps• Outliner• QuickAdd Helper filters and classes Image filters Image filters can be added to create the following effects. Use them by adding the filter name at the end of the image link, e.g. | Filter | Description | | :--------- | :--------------------------------------------------------------------------------- | | | Invert images in dark mode — ideal for charts and handwriting on light backgrounds | | | Invert images in light mode — ideal for charts and handwriting on dark backgrounds | | | Crop image to a circle | | | Add outline around image | CSS helper classes CSS helper classes can be added on a per-file basis using the YAML front matter key. These classes are composable, so you can include more than one to combine effects. For example, use the following code at the top of your file to enable cards layout: Image grids Turns consecutive images into columns. To make a new row, add an extra line break between images. Learn more. | Class | Description | | :------------- | :-------------------------------------------------- | | | Activate image grids | Line width control for tables, images and iframes Controls the width of elements by type. Learn more. | Class | Description | | :-------------------------------------- | :------------------------------------ | | , , | Fill 100% of the pane width | | , , | Fill the max line width (default 88%) | | , , | Fill the wide line width | Cards Using transforms Dataview tables into cards. Compatible with table width classes. Note that must be present for the other classes to work. Learn more.) | Class | Description | | :-------------------- | :----------------------------------------------- | | (required) | Set all Dataview tables to card layout | | | Align the last element of a card to the bottom | | | Images are resized to fill the defined space | | | Fit images in cards to 16:9 ratio | | | Fit images in cards to 1:1 ratio (square) | | | Fit images in cards to 2:1 ratio | | | Fit images in cards to 2:3 ratio | | to | Force a specific number of columns (from 1 to 8) | Tables and Dataview Controls the row and column styling for tables…