Skip to content

1.7.0 — Reading focus

Choose a tag to compare

@github-actions github-actions released this 13 Sep 00:32
· 7 commits to master since this release
46ed950

Reading focus

Keep the passage you are reading bright while dimming surrounding text, without hiding the workspace or changing pane layout.

  • Toggle with z, the native pane-header focus icon, or Toggle reading focus in the command palette.
  • The header icon reflects the active state, and a brief Obsidian notice confirms each toggle. Keyboard activation with Enter and Space is supported.
  • Focus follows the active Reading pane; other panes, link-hint overlays, and preview popups remain unchanged. The toggle state is shared, not pane-specific.
  • Configure surrounding text opacity (10–100%, default 50%) and context blocks on each side (0–5, default 2, up to 5 bright blocks total).
  • Near the start and end of a note, focus shifts toward the viewport edge so the first and last blocks remain reachable. Notes that fit without scrolling stay fully bright.
  • Focus updates on scrolling, resize, delayed image loading, and rerendering, with cleanup on view changes and plugin unload.

Settings and documentation

  • Organize settings into Scrolling, Reading focus, and Links and previews.
  • Present the Reading-mode-only introduction as a theme-aware callout.
  • Expand README with controls, defaults, active-pane behavior, and limitations.

Notes

  • Settings are saved and applied immediately; focus itself starts off after each plugin load.
  • Long lists, tables, code blocks, and embeds are treated as single blocks.
  • If the pane header is hidden, z, the command, and toggle notices remain available.
  • Minimum Obsidian version remains 1.8.7.

Verification

Build and lint checks passed on Node 20 and 22. Local Obsidian checks covered toggles, header accessibility, settings persistence, focus boundaries, pane switching, mode transitions, and reload cleanup. Full cross-platform/theme/pop-out coverage remains unverified.

Full changelog: 1.6.1...1.7.0
Pull request: #18