/obsidian-minimal

Meticulously designed to make Obsidian feel native on desktop, mobile and tablet. You can customize colors, fonts and more with the companion plugin Minimal Theme Settings.

Primary LanguageCSSMIT LicenseMIT

Minimal

Minimal is an Obsidian theme meticulously designed to feel native on desktop, mobile and tablet. You can customize colors, fonts and more with the companion plugins Minimal Theme Settings and Hider.

Support development: @kepano on Twitter or Buy me a coffee

✨ Winner of Obsidian's official Best Theme award!

Goals

  • Simplify the Obsidian UI for a more focused editing experience
  • Create a native look and feel on MacOS, iOS and iPadOS
  • Make colors, fonts, and display features customizable

Features

The following features can be toggled on/off using Minimal Theme Settings plugin:

  • Background styles — multiple levels of contrast for light and dark mode, including True Black for OLED devices
  • Focus mode — hides everything but the text when sidebars are collapsed
  • Fancy cursor — uses accent color for the cursor
  • Hide sidebar borders
  • Trim filenames
  • Relationship lines
  • Use system default cursor for UI elements

Other enhancements

  • When using Hider to turn off menu ribbon, it can be accessed by hovering over the bottom left edge of the window
  • Click + hold to zoom in on images
  • Use #invert to invert images in dark mode, e.g. ![[image.jpeg#invert]]

CSS helper classes

The following classes can be added on a per-file basis using the cssClasses YAML front matter key. The classes are composable, so you can include more than one to combine effects.

Image grids

Turns consecutive images into columns. To make a new row, add an extra line break between images.

Class Description
img-grid Activate image grids

Line width control for tables, images and iframes

Class Description
table-100, img-100, iframe-100 Fill 100% of the pane width
table-max, img-max, iframe-max Fill the max line width (default 88%)
table-wide, img-wide, iframe-wide Fill the wide line width

Embeds and transclusions

Class Description
embed-strict Transclusions appear seamlessly in the flow of text

Tables and Dataview

Class Description
table-nowrap Disable line wrapping in table cells
table-small Use small font size in tables
table-tiny Use tiny font size in tables
table-lines Add borders around all table cells
row-lines Add borders between table rows
col-lines Add borders between table columns
row-alt Add striped background to alternating table rows
col-alt Add striped background to alternating table columns

Plugin support

Gallery

Distributing Minimal forks

Minimal is licensed under the MIT License which allows you to modify and redistribute the code. The only requirement is that you must preserve the copyright and license notice in your CSS file.

If you would like to distribute a fork of Minimal please keep my Buy me a coffee link present in your Readme.

Minimal is frequently updated to stay current with the latest version of Obsidian. To make it easy to stay current with the latest improvements, I recommend using Github's fork feature so that you can merge the latest changes into your fork. If you have any questions don't hesitate to reach me in the Obsidian Discord group.

Disclaimer

This theme is provided as is, and is focused on my personal use of Obsidian on Mac OS. As such it is not thoroughly tested across all operating systems and features of Obsidian.

This theme modifies significant parts of the Obsidian interface, so it might break with future updates. It may also be incompatible with other bits of custom CSS you have. The theme file is organized in such a way that you can comment out sections that may be causing conflicts.