feat: add document tracking between neovim buffer and html render

[Or1g3n]

Do you plan to add tracking between the neovim buffer and html render?

The goal being that as you scroll the neovim buffer, the browser page moves with it, this makes reviewing the the html render side-by-side much easier. See amcco/markdown-preview.nvim. Selfishly, I would love to drop the aforementioned plugin in place of yours given yours is fully implemented in lua with no need to run a build command.

Do you foresee full feature parity at some point with the other plugin?

[selimacerbas]

Hey @Or1g3n, great suggestion — scroll sync is something I want to add.

The plan is to start with heading-based sync: as your cursor moves between sections in Neovim, the browser scrolls to the corresponding heading. The anchors are already in place so this should be straightforward and reliable, especially for documents with mermaid diagrams where proportional scrolling tends to break down.

More granular tracking within sections could come later, but heading-based should cover most real-world usage well.

[Or1g3n]

Sounds like a solid plan, thanks!

[madmonki]

scroll sync somehow doesn't work for me. it scrolls all the way down in an instant with a 42 lines file and never comes up if i scroll back up.

[selimacerbas]

@madmonki thanks for reporting this. The initial heading-based approach had issues with scroll direction consistency and limited anchor points.

v1.3.0 rewrites scroll sync entirely using line-based interpolation (similar to how peek.nvim and iamcco/markdown-preview.nvim handle it). Every block element (paragraphs, headings, lists, tables, code blocks) now gets tracked, so the browser follows your cursor with much finer precision. Scrolling up and down should both work consistently now.

Please update and let me know if it works better for you.

[madmonki]

thank you for the quick fix. it's working now!