Skip to main content

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.

Shimmering Focus brings a distinctive visual hierarchy to headings and inline text that makes long notes easier to scan and navigate. Alternating accent colors, subtle background highlights, and Live Preview level indicators all work together to make heading levels immediately distinguishable at a glance. Every aspect of this system is configurable via the Style Settings plugin.

Heading Colors

Headings use an alternating color scheme by default:
  • Odd levels (H1, H3, H5) are rendered in the theme’s --alt-heading-color.
  • Even levels (H2, H4, H6) are rendered in the standard text color.
This gives a subtle but effective visual rhythm to nested sections, making it easy to track heading depth without counting hash symbols. To disable alternating colors and render all headings in the standard text color, enable Headings: No alternating colors (no-alternating-header-colors) in Style Settings.

Heading Backgrounds

Each heading in both Source Mode and Reading View receives a subtle background fill using the --bg4 color variable, with a thin border and a small border radius. This frames headings as visual anchors within the note body. To disable heading backgrounds entirely, enable Headings: Disable background (no-heading-background) in Style Settings.

Live Preview Level Indicators

In Live Preview mode, headings that are not on the current active line display a small monospace level indicator (H1, H2, … H6) to the left of the heading text. This makes heading levels readable even when the # formatting characters are hidden by Live Preview’s render. To disable these indicators, enable Headings: No level indicators in live preview (no-lp-heading-level-indicator) in Style Settings.

Heading Typography Settings

The following settings control the font and layout of all headings:
SettingStyle Settings IDDefaultRange
Font familyfont-heading-theme"Optima", "Recursive S"Any font family string
Font size multiplierheading-scaling0.5×1.5×
Letter spacingheading-letter-spacing1.5px-2px3px
The heading scaling multiplier applies to all heading levels simultaneously. Setting it below 1 creates a more condensed note, while values above 1 are useful on large screens or for presentation-style notes.
The heading font defaults to Optima (a system font on macOS) with Recursive S as a fallback. If Optima is not available on your system, Recursive S — which is embedded in the theme — will be used automatically.

Inline Text Styling

Beyond headings, Shimmering Focus applies intentional color to common inline markup:

Bold text

Bold text is rendered in the accent color by default. Disable with Uncolored bold (uncolored-bold) in Style Settings.

Italic text

Italic text is rendered in a secondary accent color. Disable with Uncolored italic (uncolored-italic) in Style Settings.

Strikethroughs

Strikethrough text appears in red by default. Disable with Uncolored strikethroughs (uncolored-strikethroughs) in Style Settings.

Highlights

Highlighted text (==like this==) uses a yellow hue by default. The exact hue is adjustable with the Color tone of highlights (highlight-hue-1) slider in Style Settings, which accepts any hue value from 0 to 360 in steps of 5.

Inline Title

The inline title (the large note title displayed at the top of each note in the editor) uses the same heading font, weight, and letter-spacing as H1. An additional toggle — Hide inline title when more than one tab (hide-inline-title-when-more-than-one-tab) — is available for users who find it redundant when tab labels are already showing the file name.

Build docs developers (and LLMs) love