Obsidian Stats logoObsidian Stats

Wave TOC

by Hanser
5
4
3
2
1
Score: 51/100
Install Code

Description

A fluid, rail-style floating table of contents for Obsidian with smooth wave interactions.

Reviews

No reviews yet.

Stats

3
stars
1,008
downloads
0
forks
79
days
5
days
5
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
60
commits

Latest Version

1.0.8
5 days ago

Changelog

中文

  • 设置页迁移到 Obsidian 1.13 声明式设置 API，所有 Wave TOC 选项现在都能被原生设置搜索检索。
  • 移除已弃用的 display() 设置实现，并将最低支持版本更新为 Obsidian 1.13.0。
  • Release 工作流为 main.js、manifest.json 和 styles.css 生成 GitHub 构建来源证明。

English

  • Migrated the settings tab to Obsidian 1.13's declarative settings API so every Wave TOC option is searchable in native settings search.
  • Removed the deprecated display() implementation and updated the minimum supported Obsidian version to 1.13.0.
  • Added GitHub build provenance attestations for main.js, manifest.json, and styles.css.
See all version on GitHub

README file from

Github

Wave TOC

English | 简体中文

Wave TOC turns the active note's outline into a compact floating navigation rail beside the document. Move across the ticks to preview headings and nearby content, follow the current section while scrolling, or jump directly to any heading—without giving up sidebar space.

Designed for long notes, it stays accurate in both Editing and Reading views and keeps the interaction calm: scrolling changes only the active color, while the smooth wave animation appears on hover.

Requires Obsidian 1.13.0 or later.

Wave TOC in action

Highlights

  • Floating H1–H3 rail inside the active note
  • Smooth multi-tick hover wave and heading bubble
  • Theme-aware or custom highlight color with a fading gradient across neighboring ticks
  • Optional hover-card previews: title only, first paragraph, or a locally extracted section summary
  • Current section indicated by color without changing tick length
  • Configurable navigation: follow the pointer or jump only after click
  • Configurable section tracking: follow the scrolling viewport or use the cursor click behavior
  • Localized settings with Chinese and English interfaces
  • Searchable settings through Obsidian's native settings search
  • Source-line-accurate heading navigation in Editing and Reading views, including virtualized long notes
  • Automatic updates when headings change
  • Configurable side, heading depth, and rail height

Build

npm install
npm run build

Copy manifest.json, main.js, and styles.css into:

<Vault>/.obsidian/plugins/wave-toc/

Then reload Obsidian and enable Wave TOC under Community plugins. Highlight color, hover-card content, navigation, and scroll-tracking behavior can be changed under Settings → Wave TOC. The settings interface is available in Chinese and English.

Privacy

Wave TOC works locally inside Obsidian. It does not send note content to external services, collect telemetry, show ads, or require an account.

Acknowledgements

Functional research for this independent implementation included Next TOC and Floating TOC. No source code or assets from those projects are included in Wave TOC.

Wave TOC is an independent project and is not affiliated with or endorsed by OpenAI.

License

MIT © 2026 Hanser

Sponsors