Heading Jump Fix は Obsidian 用プラグイン。アウトライン、検索ペインのヒット、[[wikilink#見出し]]、[[ノート#^ブロック]] へジャンプしてもスクロールが追従しないとき、2回目のクリック相当を自動で行います。アウトラインは Enter、リンクはキーボードでも同じ補正が入ります。ネットワーク不要・無料（MIT）。
Heading Jump Fix is an Obsidian plugin. When Outline, Search pane matches, [[wikilink#heading]], or [[note#^block]] jumps move the cursor but don't scroll, it performs the second correction for you. Outline Enter and keyboard follow-link use the same path. No network requests. Free & MIT.
実際の Obsidian 上での動作イメージ Actual behavior inside Obsidian
「クリックしたのに飛ばない」を、プラグインが後追いで直します。
When a click doesn't land, the plugin finishes the jump for you.
クリック後に少し待ってから、正しい見出し行へスクロール。長文や起動直後の取りこぼしを自動でリカバリーします。
Waits briefly after each outline click, then scrolls to the correct heading line — covering long notes and app startup.
検索ペインのヒットをクリックしたあと、ライブプレビューとリーディングビューでスクロールが届くように補正します。
After a Search pane match click, corrects scroll in Live Preview and Reading view.
同じ名前の見出しが複数あっても、アウトライン上の順序で正しい方へジャンプします。
Identical headings are disambiguated by their order in the outline.
リトライ遅延（ms）と回数を設定から変更。重い Vault でも合わせ込めます。
Tune retry delay (ms) and retry count in settings to match heavier vaults.
「Jump to heading at cursor line reliably」で、カーソル行の見出しへ確実にスクロールできます。
Jump to heading at cursor line reliably scrolls to the heading that contains the cursor.
ネットワーク通信は一切なし。Vault 内の索引が無いファイルでも、本文の見出しから着地します。
No network requests. Outline jumps still land when the open file has no vault metadata cache.
ソースは GitHub で公開。気に入ったら ☕ で開発を応援できます。
Open source on GitHub. If it helps you, consider a ☕ to support development.
役割をはっきりさせた、小さくて正直なプラグインです。
A small, honest plugin with a clearly defined job.
[[wikilink#見出し]] と [[ノート#^ブロック]][[wikilink#heading]] and [[note#^block]]初期設定のままで動きます。重い Vault では遅延を増やしてください。
Works out of the box. Increase the delay for heavier vaults.
| 設定Setting | 初期値Default | 説明Description |
|---|---|---|
| プラグイン有効化Enable plugin | ON | マスタースイッチMaster switch |
| アウトライン補正Outline click fix | ON | アウトラインクリック後にスクロールを再試行Retry scroll after outline clicks |
| 検索ヒットのジャンプ補正Search result jump fix | ON | 検索ペインのヒットクリック後にスクロールを再試行Retry scroll after Search pane match clicks |
| リトライ遅延Retry delay (ms) | 250 |
補正までの待ち時間Wait before correction |
| リトライ回数Retry count | 1 |
追加スクロールの回数Extra scroll passes |
Obsidian → 設定 → Community plugins →「Turn on community plugins」
Obsidian → Settings → Community plugins → Turn on community plugins
Browse →「Heading Jump Fix」で検索 → Install → Enable
Browse → search Heading Jump Fix → Install → Enable
長いノートを開き、コアのアウトラインペインで見出しを1回クリック。それだけです。
Open a long note, click any heading once in the core Outline pane. That's it.
新しいバージョンは GitHub Releases とここに追記していきます。
New versions are published on GitHub Releases and added here.
Vault の外から開いた Markdown で、見出しキャッシュが無いときも、本文から見出しを取ってアウトライン着地します。検索のキーボード、Canvas、Bases はそのままです。
When Markdown opened outside the vault has no metadata cache, outline jumps still land by reading headings from the editor text. Search keyboard, Canvas, and Bases are unchanged.
ジャンプ先が見出し折りたたみなら開きます。親の折りたたみも開きます。ライブプレビューとリーディングビューが対象です。検索のキーボード、Canvas、Bases はそのままです。
After a jump, unfold the destination heading if it is folded, including ancestor folds, in Live Preview and Reading view. Search keyboard, Canvas, and Bases are unchanged.
リンクをたどる処理で、Obsidian のメソッドを取り出したときの this がずれないようにしました。
Bind workspace.openLinkText before wrapping, so this stays on the workspace.
アウトラインで Enter したとき、本文やリンクペインでリンクをたどったときも、クリックと同じスクロール補正が入ります。検索ヒットはこれまでどおりクリックです。
Outline Enter and follow-link (in the note or link panes) use the same scroll correction as a click. Search pane remains click-only.
検索ペインのヒットをクリックしたあと、ライブプレビューとリーディングビューで対象までスクロールします。ファイル名クリック、Omnisearch、ノート内検索はそのままです。
After a Search pane match click, Live Preview and Reading view scroll to the hit. File-title clicks, Omnisearch, and in-note Find are unchanged.
必要な Obsidian の版を 1.8.7 以上に合わせ、ポップアウト窓でも安全な要素判定に直しました。
Raised the minimum app version to 1.8.7 and switched to cross-window-safe element checks.
アウトラインや見出しリンクのあと、リーディングビューでも対象までスクロールします。分割表示にも対応します。
After Outline or heading-link jumps, Reading view also scrolls to the target. Split layouts are included.
コンソールログを廃止し、ブロック ID の型安全な検索に変更。テーマのスムーズスクロール上書きから !important を外しました。
Removed console logging, typed block-id lookup, and dropped !important from the theme scroll override.
本文とリンクペインの [[ノート#^ブロック]] クリックでも、見出しと同じくスクロールを補正します。
Corrects scroll after [[note#^block]] clicks in the note and in link panes, using the same path as heading jumps.
本文の [[wikilink#見出し]]、アウトゴーイング / バックリンク、ジャンプ後の画面内確認と backoff を追加。コミュニティ掲載を継続します。
Adds in-note [[wikilink#heading]] and link-pane correction, on-screen verification with backoff. Stays listed as a Community plugin.
テーマの scroll-behavior: smooth で見出しを外す問題を設定で上書き。開発者コンソール向けのデバッグログ（既定オフ）。
Optional override so theme scroll-behavior: smooth does not miss the heading. Opt-in debug log in the developer console.
アウトラインクリック補正・同名見出しの判別・リトライ設定・カーソル行ジャンプコマンドを搭載。
Outline click fix, duplicate-heading disambiguation, retry settings, and the cursor-line jump command.
Heading Jump Fix は無料・オープンソースです。役に立ったら、コーヒー1杯分の応援が今後のアップデートの励みになります。
Heading Jump Fix is free and open source. If it saved you some clicks, a coffee helps keep the updates coming.
