quarto-link-previews

JavaScript
Quarto
Hover previews for internal links on Quarto websites.

quarto-link-previews is a Quarto extension that shows a popover preview of the target page when you hover over an internal link, the pattern popularized by Quartz digital gardens and Obsidian’s page previews.

The extension previewing its own documentation

Why

I saw the hover previews on jzhao.xyz and wanted them for this site. It turned out no Quarto extension existed: link previews have been an open feature request on the Quarto tracker since 2022 (discussion #2427) without a shipped implementation. So I built one and published it.

How it works

Quarto already ships tippy.js on every HTML page for its footnote and cross-reference hovers. This extension reuses that bundle: on hover it fetches the target page, extracts the title block and article content, and shows the result in a popover that inherits the site theme.

Features

  • Anchor links open the preview scrolled to the target section.
  • Configs for delay, width, extracted content, and excluded selectors, plus per-link and per-page opt-outs.
  • Styling through CSS custom properties; colors follow Quarto’s tippy theme, with native support for light and dark.
  • Zero-dependency test suite; CI renders the demo site against the oldest supported Quarto and the current release.

Documentation and live demo, or install with quarto add ravila4/quarto-link-previews.