README file from
GithubObsidian Theme: Elegance Enhanced

✨ What's New in v2.0
Enhanced Edition - Major Update
This enhanced version builds upon the original Elegance theme with significant improvements:
🎛️ Style Settings Compatible ✅
- 20+ customizable options via Style Settings plugin
- Control font sizes, colors, spacing without editing CSS
- Real-time visual adjustments from the UI
📎 Improved Embedded Notes ✅
- Configurable height (0-1500px or unlimited)
- Custom scrollbars matching the theme
- Smooth scroll option
- Auto-height mode available
🖱️ Native Zoom Support ✅
Ctrl + Scrollworks perfectly out of the boxCtrl + +/-keyboard shortcuts- No additional setup required
🎴 Integrated Snippets ✅
Built directly into the theme:
- Cards for Dataview (books, games, movies)
- Quiet Outline custom styling
- MathJax visual improvements
- Kanban text optimization
⚡ Performance Optimizations ✅
- Enhanced font rendering
- Consistent scrollbars everywhere
- Respects reduced motion preferences
- Better accessibility support
Screenshots
Dark Mode

Light Mode

Style Settings Panel (New!)
Configure everything visually - no CSS editing needed.
📥 Installation
Method 1: From Obsidian Community Themes (Recommended)
- Open Settings in Obsidian
- Go to Appearance → Themes → Manage
- Search for "Elegance Enhanced"
- Click Install and then Use
Method 2: Manual Installation
- Download the latest release
- Extract to
.obsidian/themes/elegance-enhanced/ - Restart Obsidian
- Enable in Settings → Appearance → Themes
🎨 Unlock Full Customization
Install Style Settings plugin:
- Settings → Community Plugins → Browse
- Search "Style Settings"
- Install and enable
- Access options: Settings → Style Settings → 🎨 Elegance Theme
✨ Features
🎨 Original Features
🌈 Rainbow Headers
Beautiful gradient-style headers for visual hierarchy.
🔍 Zoomable Images
Click and hold any image to zoom in.
⬅️➡️ Image Alignment
Position images easily:
![[image.png|left|200]] # Left aligned
![[image.png|right|200]] # Right aligned
![[image.png|center|200]] # Center (default)
💊 Pill Tags
Special styling for workflow tags:
#ToDo- Yellow pill#InProgress- Blue pill#Completed- Green pill
📝 Active Line Highlighting
Visual guide for the current editing line.
🎬 Smooth Note Transitions
Elegant animations when switching notes.
📊 Resizable Tables
Drag the bottom-right corner to resize.
🖼️ Image Captions
Special callout for image descriptions:
> [!imagen]- Your caption here
> 
✨ New Enhanced Features
🎛️ Style Settings Integration
Access all these settings visually in Settings → Style Settings → Elegance Theme:
📝 Typography
- Font size base (12-24px)
- Code font size (10-20px)
- Line height (1.2-2.5)
- Headers H1-H6 (individual control)
📎 Embedded Notes
- Max height (0-1500px, 0 = unlimited)
- Border radius (0-20px)
- Internal padding (0-40px)
- Shadow on hover (toggle)
- Smooth scroll (toggle)
⚙️ Interface
- Sidebar font sizes
- Status bar font size
- Scrollbar width (4-16px)
🎨 Colors (if you want to add them)
- Accent colors
- Background colors
- Text colors
📎 Improved Embedded Notes
Embedded notes (![[note]]) now have:
- ✅ Configurable maximum height
- ✅ Custom scrollbar matching theme
- ✅ Smooth scroll option
- ✅ Unlimited height mode
- ✅ Better padding and spacing
Example:
![[My Long Note]]
Will display with scrollbar if content exceeds the configured height.
🖱️ Native Zoom
Works out of the box:
Ctrl + Scroll- Zoom in/out with mouse wheelCtrl + +- Zoom inCtrl + -- Zoom outCtrl + 0- Reset zoom
No configuration needed - it's Obsidian's native feature!
🎴 Integrated Snippets
All these features are built into the theme - no separate snippets needed!
📚 Dataview Cards
Transform Dataview tables into beautiful cards.
Usage:
---
cssclass: cards
---
```dataview
TABLE WITHOUT ID
file.link as "Title",
author as "Author",
cover as "Cover"
FROM "Books"
```
Card Types:
cssclass: cards- Standard cards (books, general)cssclass: cards-games- Compact cards for video gamescssclass: cards-movies- Horizontal cards for movies/series
Column Control:
cards cards-cols-3- 3 columnscards cards-cols-5- 5 columns
✅ Enhanced Checkboxes (Minimal Theme)
For a lighter theme, checkboxes are not included by default. Download from: Minimal Theme Checkboxes
| Syntax | Description |
|---|---|
- [ ] |
to-do |
- [x] |
done |
- [-] |
canceled |
- [>] |
forwarded |
- [<] |
scheduling |
- [?] |
question |
- [!] |
important |
- [*] |
star |
- ["] |
quote |
- [l] |
location |
- [i] |
information |
📐 MathJax Improvements
Better rendering for long arrows and lines in equations:
$$A \xrightarrow{\text{long text}} B$$
📊 Kanban Styling
Optimized text sizing and spacing for Kanban boards.
📋 Quiet Outline
Custom styling for the Quiet Outline plugin with theme colors.
🎨 Style Settings
How to Use
- Install Style Settings plugin
- Go to Settings → Style Settings
- Find 🎨 Elegance Theme
- Adjust options with visual sliders and toggles
Available Options
Typography Section
- Base font size
- Code font size
- Line height
- H1, H2, H3, H4, H5, H6 sizes
Embedded Notes Section
- Maximum height slider
- Border radius
- Internal padding
- Show shadow (toggle)
- Smooth scroll (toggle)
Interface Section
- Sidebar font sizes
- Status bar size
- Scrollbar width
Without Style Settings
You can still use the theme! It works perfectly with default values. To customize:
- Open
theme.css - Find the
:rootsection - Edit values like
--font-size-normal: 16px; - Save and reload Obsidian (
Ctrl+R)
🚀 Performance
Optimizations
- ✅ Optimized font rendering (
antialiased) - ✅ Efficient CSS selectors
- ✅ Reduced reflows
- ✅ Respects
prefers-reduced-motion - ✅ Better accessibility (focus indicators)
System Preferences
The theme respects:
- Reduced motion - Disables animations if system preference is set
- High contrast - Adapts to system settings
📱 Mobile Support
Current status: Partial support
The theme works on mobile but some features are optimized for desktop. Mobile-specific improvements are planned for future updates.
🐛 Troubleshooting
Ctrl+Scroll doesn't work for zoom
- Make sure you're focused on the editor (click on your note first)
- Some plugins might interfere - try disabling them
- Works in Obsidian v0.16.0+
Style Settings options don't appear
- Make sure Style Settings plugin is installed and enabled
- Restart Obsidian after installing the plugin
- Check that you're using the latest version of the theme
Embedded notes are too tall/short
- Open Settings → Style Settings → Elegance Theme → Embedded Notes
- Adjust "Maximum height" slider
- Set to 0px for unlimited height
Cards don't display
- Make sure Dataview plugin is installed
- Add
cssclass: cardsto your note's frontmatter - Check your Dataview query syntax
📋 Changelog
v2.0.0 - Enhanced Edition (2025)
- ✅ Added Style Settings compatibility
- ✅ Improved embedded notes with configurable height
- ✅ Integrated 4 popular snippets into theme
- ✅ Fixed native zoom support
- ✅ Performance optimizations
- ✅ Better accessibility
- ✅ Consistent scrollbars
- ✅ Respects motion preferences
v1.0.0 - Original Release (2023)
- Initial release with core features
💡 Tips & Tricks
Combining Features
Example: Book Library with Cards
---
cssclass: cards cards-cols-4
---
```dataview
TABLE WITHOUT ID
file.link as "📖",
author as "✍️",
"" as "",
rating as "⭐"
FROM "Library"
SORT rating DESC
```
Custom Variables
You can create your own custom styling:
/* In a CSS snippet */
.my-custom-note {
--font-size-normal: 18px;
--embed-max-height: 800px;
}
🤝 Contributing
Contributions are welcome! Here's how you can help:
Report Issues
Found a bug? Open an issue
Include:
- Obsidian version
- Theme version
- Steps to reproduce
- Screenshots if applicable
Suggest Features
Have an idea? Open a feature request!
Submit Pull Requests
- Fork the repository
- Create a feature branch
- Make your changes
- Test thoroughly
- Submit a PR with clear description
📄 License
MIT License - Copyright (c) 2023-2025 Víctor Alonso Arribas
See LICENSE file for details.
👏 Credits
Original Theme
Víctor Alonso Arribas (@Victologo)
- Biology student at University of Alcalá de Henares (Spain)
- YouTube: Victólogo (Spanish Obsidian tutorials)
- Instagram: @victologoyt
David Catalá Merino
- Theme co-creator
- Instagram: @x.akira_71.x
Enhanced Version (v2.0)
- Style Settings integration
- Performance optimizations
- Snippet integration
- Documentation improvements
Inspired By
- Dracula for Obsidian - Base theme
- Bubble Space - Structure and snippets
- Blue Topaz - Code and snippets
- Minimal - Cards and checkboxes
- Danny Hatcher theme - Code inspiration
- Bryan Jenks theme - Code inspiration
Special Thanks
- Jose (Snifer@L4b's)
- Obsidian community
- Style Settings plugin by @mgmeyers
- All contributors and users!
💬 Support
Get Help
Stay Updated
- ⭐ Star this repo to show support
- 👀 Watch for updates
- 📢 Share with the community
Contact
- 📧 Email: [email protected]
- 🎥 YouTube: Victólogo
- 📷 Instagram: @victologoyt
.jpg&w=3840&q=75)