Elegance

by victologo
Screenshot of the Elegance Obsidian theme
5
4
3
2
1

Description

This theme supports Dark Mode
This theme supports Light Mode

README file from

Github

Obsidian Theme: Elegance Enhanced

Miniatura - 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 + Scroll works perfectly out of the box
  • Ctrl + +/- 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

image

Light Mode

image

Style Settings Panel (New!)

Configure everything visually - no CSS editing needed.


📥 Installation

  1. Open Settings in Obsidian
  2. Go to AppearanceThemesManage
  3. Search for "Elegance Enhanced"
  4. Click Install and then Use

Method 2: Manual Installation

  1. Download the latest release
  2. Extract to .obsidian/themes/elegance-enhanced/
  3. Restart Obsidian
  4. Enable in SettingsAppearanceThemes

🎨 Unlock Full Customization

Install Style Settings plugin:

  1. SettingsCommunity PluginsBrowse
  2. Search "Style Settings"
  3. Install and enable
  4. Access options: SettingsStyle 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
> ![](https://raw.githubusercontent.com/victologo/elegance-theme/HEAD/image.png)

✨ 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 wheel
  • Ctrl + + - Zoom in
  • Ctrl + - - Zoom out
  • Ctrl + 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 games
  • cssclass: cards-movies - Horizontal cards for movies/series

Column Control:

  • cards cards-cols-3 - 3 columns
  • cards 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

  1. Install Style Settings plugin
  2. Go to Settings → Style Settings
  3. Find 🎨 Elegance Theme
  4. 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:

  1. Open theme.css
  2. Find the :root section
  3. Edit values like --font-size-normal: 16px;
  4. 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: cards to 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 "✍️",
  "![" + cover + "](" + cover + ")" 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

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. 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

Enhanced Version (v2.0)

  • Style Settings integration
  • Performance optimizations
  • Snippet integration
  • Documentation improvements

Inspired By

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