Minimal Example

The smallest setup that produces hover previews: install the extension, point _quarto.yml at the filter, done. This page is the result. Hover the links under Result.

Setup

quarto add ravila4/quarto-link-previews

_quarto.yml

project:
  type: website

filters:
  - ravila4/link-previews

Previews inherit your site theme, light and dark.

Result

Hover the coffee-ring page for a full page preview, or a section inside the long page to open the preview already scrolled to that heading.

Links the extension leaves alone: external ones like Quarto, and any anchor carrying the no-preview class, like this link to the same coffee-ring page.

Optional configuration

Every key below is optional and shown at its default.

_quarto.yml

extensions:
  link-previews:
    enabled: true       # false anywhere disables previews for that scope
    content: "#title-block-header, #quarto-document-content"
    delay: [300, 0]     # tippy show/hide delay in ms
    max-width: 500      # popover width in px
    exclude: []         # CSS selectors whose links never preview

The same block works in a page’s front matter, where it replaces the site settings for that page. The long page does exactly that to widen its own previews to 640px.

See the documentation for the full reference, styling hooks, and known limitations.