Skip to content
CONSTRUCTING

UnoCSS Plugin Beta

Word count
722 words
Reading time
5 minutes

When crafting documentation in Nólëbase, creating numerous visual components is crucial for enhancing the documents with dynamic and interactive user interfaces. This not only makes the content more digestible but also more engaging. Previously, Obsidian lacked the functionality to effectively integrate and apply styles from atomic CSS frameworks like Tailwind CSS and Windi CSS to HTML elements within its platform.

This is where Obsidian UnoCSS Plugin kicks in, it allows you to write your notes in Obsidian with UnoCSS. By doing so, it has built a bridge by allowing the use of sufficiently simple and user-friendly atomic CSS classes, which enhances the aesthetics and functionality of the notes and documents we write in Obsidian.

What can you do with it

  • Embed interactive components in your notes.
  • Style your notes with atomic CSS classes.
  • Use themes and color schemes from UnoCSS communities.
  • Import the icons from Iconify.
  • Animate your notes.
  • Documenting color theories.
  • Documenting UI/UX knowledge.
  • Demonstrating the back scene of Mathemathics and Physics like manim
  • And more...

Demos

Show me what you can do

How it looks like


What is the markup like

It's all basic just a set of HTML.

WARNING

To learn more about what are the meanings of classes, I recommend you to use the documentation sites of Tailwind CSS and Windi CSS as references.

Hot-reloading capabilities in live preview mode

INFO

To do so, you need to split your Obsidian view into two panes, and choose "Source mode" for the editing pane where you wanted to view and edit the HTML markup.

How to use it

WARNING

Currently Obsidian UnoCSS Plugin is in alpha stage, it wasn't guaranteed to work properly and keep the compatibility with the future versions of itself.

But it is encouraged to try it out and give feedbacks. If you find and bugs or have any suggestions, please feel free to open an issue on GitHub.

Currently, it is a bit hard to install the plugin for now before it is published to the official Obsidian plugin store. Manual downloading and installation is required.

Install with beta testing helper BRAT plugin

  1. Install the BRAT plugin right from the official Obsidian plugin store.
Never learned how to install a plugin?
  1. Go to "Preferences" or "Settings" (click the little gear icon on the bottom left corner of Obsidian).
  2. Click "Community plugins" in the settings menu.
  3. Turn on "Community plugins"

  1. Click the "Browse" button to search for the BRAT plugin.

  1. Search for "BRAT" and click the "Obsidian42 - BRAT" plugin.

  1. Click "Install" to install the desired plugin.
  1. Enable the BRAT plugin in the community plugins settings menu.
How to enable a plugin?
  1. Go to "Preferences" or "Settings" (click the little gear icon on the bottom left corner of Obsidian).
  2. Click "Community plugins" in the settings menu.
  3. Find the desired plugin that you wanted to enable in the "Installed plugins" list.

  1. Toggle on the right switch.
  1. Open Command palette to choose "BRAT: Plugins: Add a beta plugin for testing" as follows:

  1. Copy and paste the following link to the first field of the new prompted dialog:
txt
https://github.com/nolebase/obsidian-plugin-unocss
  1. Find the needed released version on Release page of Obsidian UnoCSS Plugin, for example, fill in 0.1.0:

  1. Enable the "UnoCSS" plugin from the "Installed plugins" list.

Install manually

  1. Navigate to the Release page of Obsidian UnoCSS Plugin
  2. Find the latest version of the plugin.
  3. Download the main.js file and manifest.json file.
  4. Open up the .obsidian/plugins directory of your Obsidian vault.
  5. If no .obsidian/plugins directory exists, create one.
  6. Create a new directory named obsidian-plugin-unocss inside the .obsidian/plugins directory.
  7. Move main.js file and manifest.json file into the obsidian-plugin-unocss directory.

The directory structure should look like this after these steps:

shell
 tree
.
├── main.js
├── manifest.json
  1. Enable the "UnoCSS" plugin from the "Installed plugins" list.

Contributors

Changelog