Shimmering Focus enhances both images and tables to make notes more readable and visually informative. Images gain automatic captions and intuitive zoom behavior; tables gain alternating row colors and active cell highlighting. Each feature is configurable via the Style Settings plugin and several are available as standalone CSS snippets for use without the full theme.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/chrisgrieser/shimmering-focus/llms.txt
Use this file to discover all available pages before exploring further.
Images
Automatic Captions from Alt Text
When an image has alt text set, Shimmering Focus renders that alt text as a caption below the image automatically. The caption uses a small, italic, muted font and is centered below the image. No plugin or additional syntax is required — the standard Markdown image syntax is enough:Captions are only generated when alt text is explicitly provided and is not just a filename. The theme skips alt text ending in
.png, .jpg, .jpeg, .tiff, .heic, .icns, or .webp. To disable captions entirely, enable Images: No alt-text as caption (no-image-alttext-caption) in Style Settings.Reduced Image Size
By default, images are displayed at 50% of their container width. This prevents large screenshots or photos from overwhelming note content, especially useful on wide monitors or high-resolution displays. The size can be adjusted from10% to 100% with the Images: Size (image-size) slider in Style Settings.
A command is also added to the command palette — Toggle between reduced and full image size — which switches between the configured reduced size and 100% on the fly without needing to open Style Settings.
Click-and-Hold Zoom
Any image can be zoomed in by clicking and holding with the mouse. The image enlarges while the mouse button is held and returns to reduced size when released. The cursor changes to a zoom-in icon on hover to indicate this behavior.Image Settings Summary
| Setting | Style Settings ID | Default | Description |
|---|---|---|---|
| Image size | image-size | 50% | Reduced width as a percentage of container |
| Disable captions | no-image-alttext-caption | Off | Hides alt-text captions below images |
Tables
Alternating Row Colors
Table rows alternate between the standard background and a slightly lighter or darker--table-row-alt-background color. This makes it much easier to track rows across wide tables without a ruler or careful eye movement.
Active Cell Highlighting
When editing a table in Live Preview, the currently focused cell is highlighted with a2.5px accent-colored outline. This makes it immediately clear which cell is being edited, which is especially helpful in tables with many closely spaced cells.
Active cell highlighting requires Obsidian installer version 1.1.9 or later. A standalone version of this feature is also available as the
highlight-active-table-cell.css snippet in the theme’s snippets/ directory.Auto-disable Readable Line Length for Tables
Wide tables often look cramped or cause horizontal scrolling when Obsidian’s Readable line length setting is active. Enabling Automatically disable readable line length on notes with tables (unrestricted-line-length-tables) causes the theme to automatically set the line width to 100% whenever the current note contains a table, then restore the configured line length in notes without tables.
| Setting | Style Settings ID | Default | Description |
|---|---|---|---|
| Disable readable line length on table notes | unrestricted-line-length-tables | Off | Expands editor width to full in notes with tables |