✨ MagicUser is a custom theme for Obsidian.md that provides a pleasant and focused note-taking experience, with light and dark themes for day and night use.

In conjunction with the Style Settings community plugin, the MagicUser theme offers 200+ options for customization, including multiple preset themes, UI modes, and many special effects. Whether you prefer a clean, minimalist look or a vibrant interface, you can adjust colors, fonts, and layouts to match your workflow and personal color palette aesthetic.

1. Open Obsidian Settings -> select Appearance

2. Themes -> click Manage -> search for MagicUser

3. Select the theme -> click Install and use

No extra plugin required.

Style Settings community plugin required.

No extra plugin required.

MagicUser Page (MUP) Backgrounds allow you to visually categorize your notes based on their purpose. Instead of every note looking the same, you can assign "modes" to specific notes for better mental context-switching.

---
cssclasses:
  - mup-purple
---

• Automatic Rainbow Colored Folders. You can activate/deactivate this feature using the Command Palette.

• Folder Icon Styles: You can select from 3 different folder styles for open and closed states (in Style Settings).

• Folder and File Colors:

  • You can select colors more intuitively using color pickers.
  • You can select specific colors for closed folders, open folders, and files (for both light and dark modes).

• You can also show/hide folder icons and file icons.

• Outline UI - sidebars
• Outline UI - active icons and elements
• Outline UI - select border color (light/dark modes)

• Select the style of the tabs (3 options): default tabs, square tabs and pill tabs. You can also customize other tabs colors.

• New breadcrumb layout (view header breadcrumb). The breadcrumb folders will have the same border and background colors of the sidebar open folder area (file explorer).

• You can also have an additional layout (Slanted breadcrumb - without the / separator and more compact. You can activate the slanted breadcrumb layout using Style Settings.

Enhance your reading experience with personalized reading focus and comfort.

• MagicUser laser will be displayed in live preview, source and reading modes.

• Reading Mode: Reading glow effect.
• Style Settings: Reading glow color (7 colors).
• Style Settings: Reading glow border size.
• Style Settings: Reading glow corners size (0 = square corners).

This feature dynamically adjusts the font size of the current line for enhanced focus while typing or reading.

• Live preview and source modes: The font size of the line containing the cursor is temporarily magnified.
• Reading mode: Clicking on a line in reading mode activates a temporary zoom effect.
• Active line zoom can be toggled on or off via a shortcut key or the Command Palette.

Hover underline (live preview, source and reading modes).

• Toggle hover underline (shortcut and/or Command Palette).

You can customize the indent guides colors using the Style Settings plugin (independent colors for light and dark modes).

• Style Settings: select sidebar open folder area border color.
• Style Settings: select sidebar open folder area background color.
• Style Settings: hide sidebar open folder area.

• Style Settings: Enable dark sidebar in light mode (compatible with preset themes)

You can customize the neon mode headings colors using the Neon Mode Headings submenu.

Outline Neon mode enlarges headings for effortless reading, all while keeping your text neon-highlighted. Choose your preferred style.

• Normal mode
• Neon mode
• Outline neon mode

You can toggle underline headings using a shortcut or the Command Palette.

- **General todo and task status**:
  - #todo
  - #inprogress
  - #ready
  - #completed
  - #implemented

- **Alerts**
  - #attention
  - #warning
  - #caution  

- **Academic**:
  - #article
  - #reference
  - #citation 
  - #cheatsheet
  - #review
  - #research
  - #watch
  - #test

- **Solo/Team tags**:
  - #solo
  - #team

- **Schedule**:
  - #date
  - #appointment
  - #meeting
  
- **General purpose**:
  - #study
  - #work
  - #family
  - #finances
  - #video
  - #bookmark
  - #important
  - #favorite
  - #wishlist
  - #reminder
  - #art
  - #idea
  - #magic

- **Stars rating tags**:
  - #s1
  - #s2
  - #s3
  - #s4
  - #s5

- **School grading system**:
  - #gA
  - #gB
  - #gC
  - #gD
  - #gF

• Instead of just dimming the screen, the warm scren mode adjusts the light spectrum towards warmer tones (red, orange, yellow) and reduces cooler tones (e.g. blue).
• Warmer tones are considered less harsh on the eyes, especially in low-light environments or extended use.
• The warm screen mode can create a more relaxing and soothing atmosphere for reading, working, or viewing media.
• If you embed PDFs, you will be able to read them with warmer screen color.

• You can adjust the warm screen mode intensity (using the slider).
• To turn it off, set the slider to zero (default option).

To show the left ribbon, place your cursor on the left side of the screen, it will hide again when you move your cursor away from the left side of the screen.

• You can also auto hide the status bar (UI Advanced).

Total concentration mode goes beyond distraction-free mode. It creates a state of flow unhindered by any visual interruptions. Focus solely on your writing or reading.

• Toggle total concentration mode quickly using a shortcut or Command Palette.

• Checkbox shape: default (rounded corners), square and circle.

> [!g- + color] Callout Title

> [!g- + color|number of columns] Callout Title

Number of columns: 1 - 5

Colors: white, black, gray

> [!g-white] Your Callout Title
> Place image 1 link (image 1)
> Place image 2 link (image 2)
> Place image n link (image n)

> [!g-gray|5] Your Callout Title
> Place image 1 link (image 1)
> Place image 2 link (image 2)
> Place image n link (image n)

> [!m- + color] Callout Title

Colors: white, black, gray

> [!table]

You can add a table inside the table callout and adjust the table size/width according to the page.

> [!table + |30% - 100%] (percentage of the page occupied by the table)

• Values: 30%, 40%, 50%, 60%, 70%, 80%, 90% and 100%.
• You can also center the table (just add center after the percentage).
• Don't forget to leave an empty line before inserting the table.

> [!table] Table 1
> 
> | Column 1  | Column 2 |  Column 3 |
> | :---:     | :---:    |  :---:    |
> | Text 1    | Text 2   | Text 3    |
> | Text 4    | Text 5   | Text 6    |
> | Text 7    | Text 8   | Text 9    |

> [!table|70%] Table 1
> 
> | Column 1  | Column 2 |  Column 3 |
> | :---:     | :---:    |  :---:    |
> | Text 1    | Text 2   | Text 3    |
> | Text 4    | Text 5   | Text 6    |
> | Text 7    | Text 8   | Text 9    |

> [!table|50% center] Table 1
> 
> | Column 1  | Column 2 |  Column 3 |
> | :---:     | :---:    |  :---:    |
> | Text 1    | Text 2   | Text 3    |
> | Text 4    | Text 5   | Text 6    |
> | Text 7    | Text 8   | Text 9    |

> [!hl- + color] Your Callout Title

Colors: green, blue, orange, yellow, red, pink, purple

> [!p- + color] Your Callout Title

Colors: green, blue, orange, yellow, red, pink, purple

> [!q- + color] Quote

Colors: green, blue, orange, yellow, red, pink, purple

> [!b- + color] Your Callout Title

Colors: green, blue, orange, yellow, red, pink, purple

> [!ub- + color]

Colors: green, blue, orange, yellow, red, pink, purple

> [!l- + color] Your Title

Colors: green, blue, orange, yellow, red, pink, purple

Center the content by adding |center as shown below:

> [l-+ color|center] Your callout title

To align right, use |right.

> [!lb- + color] Your Title

Colors: green, blue, orange, yellow, red, pink, purple

> [!h1 to h6- + color] Your Title

Colors: green, blue, orange, yellow, red, pink, purple

Center the callout heading by adding |center as shown below:

> [h1 to h6- + color|center] Your callout title

To align right, use |right.

• Use flashcards to practice active recall and track your study progress. You can create individual flashcards or organize them into groups for specific subjects.
• The theme provides color guides to visually distinguish groups and individual flashcard callout headers, making it easier to categorize, edit, and create flashcards accurately.

> [!fc-group] Flashcard group title
> > [!fc] Question 1
> > Answer 1.
>
> > [!fc] Question 2
> > Answer 2.

> [!fc] Question 1
> Answer 1.

> [!fc-group] MagicUser Flashcards - General Knowledge Deck 1
> > [!fc] What is the largest planet in our solar system?
> > **Jupiter** is the largest, with a mass more than two and a half times that of all the other planets in the Solar System combined.
>
> > [!fc] Which element has the chemical symbol 'O'?
> > **Oxygen**. It is a highly reactive nonmetal and an oxidizing agent that readily forms oxides with most elements.
>
> > [!fc] How many continents are there on Earth?
> > There are **seven**:
> > 1. North America
> > 2. South America
> > 3. Africa
> > 4. Europe
> > 5. Asia
> > 6. Oceania
> > 7. Antarctica

> [!fc-group|no-animation] Static Flashcard Group
> > [!fc] This card will not flip.
> > The answer is visible or appears without transition.

• All callouts can be resized. You can use the same syntax as table callouts in other callouts to resize them on screen (also center them).

> [!callout-name|percentage] or

> [!callout-name|percentage center]

> [!question|80% center] Your callout title
> Your callout content

• When selecting text, the main edit cursor/caret will have a different width for better visibility (no blinking caret).

• Additional carets/cursors have a different width and no blinking carets (solid appearance).

• It works inside code samples and normal editor areas.
• Active line number will have the same color of the text cursor/caret.

• Inline interactive comments. You can add inline comments to any part of your note, and when you hover over it, the content will be displayed in a box. The comment icon will be highlighted.

• You can add HTML bold <b>, italic <i>, links <a href>, <u>, <mark> tags in order to format your comments to make it easier to you to review them.

• They were designed for quick comments 1 - 4 paragraphs.

• The inline comments will not be printed or exported to PDF.

Syntax:

1. Add the <i> tag with the class muc (MagicUser Comment)
2. Inside <i class="muc"> just add a <span> tag with your comment. There is no need to add any class to the span tag.

This is the text of your note <i class="muc">
  <span>
    This is your first inline comment.
  </span>
</i>

This is the text of your note <i class="muc"><span>This is your inline comment.</span></i>

The default underline color is red, but you can change it using the Style Settings plugin. You can also add 7 classes to make the text underlined. When you hover the underlined text it will become highlighted (underlined too). Please check the syntax below.

Text <u>underlined text</u>.

Text <u>default underline</u>
Text <u class="blue">blue underline</u>.
Text <u class="green">green underline</u>.
Text <u class="yellow">yellow underline</u>.
Text <u class="orange">orange underline</u>.
Text <u class="red">red underline</u>.
Text <u class="purple">purple underline</u>.
Text <u class="pink">pink underline</u>.

You can <u class="hide">hide</u> the text.

You can <u class="hide-c">hide</u> the text.

You can <u class="hide-r">hide</u> the text.

You can <u class="hide-rc">hide</u> the text.

Question: What is the name of this theme? <u class="hide-w">MagicUser</u>

Text <mark>highlighted text</mark>

Normal default mark <mark>default highlight</mark>.
Text <mark class="blue">blue highlight</mark>.
Text <mark class="green">green highlight</mark>.
Text <mark class="yellow">yellow highlight</mark>.
Text <mark class="orange">orange highlight</mark>.
Text <mark class="red">red highlight</mark>.
Text <mark class="purple">purple highlight</mark>.
Text <mark class="pink">pink highlight</mark>.

Default theme table layout:

• Improved table layout (all preset themes - light and dark modes). The colors of the tables will adapt to the different background colors of the preset themes.

---
# Display table to cards (2 columns)
cssclasses:
  - cards
  - cards2
---

---
# Display table to cards (5 columns)
cssclasses:
  - cards
  - cards5
---

• You can customize the color of the footnotes (Style Settings). The default color is orange (light/dark modes).

The syntax highlighting in this theme is similar to the MagicUser themes for VS Code (MagicUser and MagicUser Light Blue).

• Style Settings
• Excalidraw
• Dataview
• Dashboard Navigator
• Kanban
• Calendar
• Full Calendar
• Tasks
• Commander
• Banners

The name “MagicUser” for the themes I create has a deep meaning for me:

1. Like a Magic User Class: It references the concept of a “MagicUser” class in object-oriented programming languages. Similar to how a programmer uses a class to define objects. MagicUser class would be used to create magic users. Notably, “MagicUser” follows the common convention in many programming languages of writing class names in PascalCase, where the first letter of each word is capitalized.

2. Personal Connection: But there’s a deeper meaning! This resonates strongly with me because in the late 80s and 90s, I played a game series that had a huge impact on my life, called Quest for Glory (originally known as Hero’s Quest: So You Want to Be a Hero). You could play as a fighter, a thief, or as a magic user/wizard. As you can guess, I played as the magic user.

   • In the second game, there was a quest where the player could strive to become a Paladin. The core values of the Paladin class resonated deeply with me. Still remember that board of quests, one of them was “The Way of the Paladin: To seek. To learn. To do.” Even though it was a game, the values became a guiding light for me, emphasizing seeking knowledge, continuous learning, and using that knowledge and your abilities to help others.

   • If you played the game and were good enough to become a Paladin, this only happened at the end of the second game (or during the third game).

While themes may come and go, hopefully, the underlying message will remain a constant.

Now you know the reasons why it’s called MagicUser.

Have suggestions for new features, usability improvements, or found a bug? Your feedback is appreciated! Submit an issue on GitHub and I'll do my best to respond as soon as possible. Every voice matters and helps shape the future of this theme. Thanks.

MagicUser Theme for Obsidian

MIT License ⓒ Bernardo Pires

Most of the icons for the checkboxes and the quote icon were created by me (MIT License). You can find the comment in the embedded SVGs.

The icons used by the file icon, other callouts and some checkboxes icons are from Lucide Icons used by Obsidian. The Lucide icon library is licensed under the ISC License.

Some checkbox icons were inspired by the excellent Minimal Theme by Stephan Ango (@kepano) and the Things Theme by Colin Eckert (@colineckert). You can find more information about @kepano and @colineckert below, please check their themes and support their work:

• Minimal Theme by Stephan Ango

• Things Theme by Colin Eckert

Style Settings Community Plugin

• Thanks to Matthew Meyers (@mgmeyers) for the amazing Style Settings Plugin. Excellent work.

Thanks for the Suggestions

I would like to express my gratitude to everyone who offered suggestions, tested each new feature, and provided invaluable feedback. Thanks to your attention to detail and constructive criticism, the theme has evolved into what it is today.

• @alitekdemir - suggestion to add the extra checkboxes (extra 1 - screenshot), based on Minimal and Things Themes. I hope you also find them useful.
• @YannMiro - suggestion to show/hide file icons.
• @zhouxinghong - reading mode suggestions (display H1-H6 labels on hover, colored H1-H6 labels) and colored indent guides in file explorer. Style Settings Theme Options (collapse indicator color). Rounded tables suggestion.
• @ll14m4n - dataview tables and stacked mode suggestions. Suggestion to change neon heading colors and links in headings (when neon mode is on).
• @golden234431 (Obsidian Forum) - inline title font size.
• @fred.joe3697 (Obsidian Forum) - underlined text color, hidden text underline and inline comments suggestions. Callouts without title suggestion. Preset tables suggestions, disable table row background change and table text color. Hover underline suggestion.
• @New (Obsidian Forum) - note width suggestion.
• @YonKuma (Obsidian Forum) - hide headings labels.
• @merlinuwe - scrollbars customization suggestion. Numbered tables suggestion. Colored indent guides for lists. Hide indent guides and suggestions (issue #62). Open in new window border.
• @indigofairyx - outline code and outline blockquote suggestion. Outline sidebars. Transparent menus blur effect. Tags suggestions.
• @Medullitus - panel divider hover color suggestion (Style Settings option). Suggestion to select the color of sidebar tags count number.
• @tr_mstein (Obsidian Forum) - independent outline code for inline code and code block.
• @damiankorcz - disable alternative checkboxes suggestion.
• @TineKolenik - hide tabs icons suggestion.
• @chrsdk - highlighted text foreground color suggestion. Line margins for mobile phone.

I'm also grateful to everyone who took the time to star this repository. It really gives me extra motivation to keep improving this theme. I hope you find it useful in your daily work/study.

Special congratulations to the Obsidian.md team for creating a great software application.