Files
quartz/docs/plugins/StackedPages.md
saberzero1 bc1c6a47d8 docs: fix incorrect plugin option defaults and phantom options
- Citations: remove non-existent prettyLink option
- Explorer: correct folderClickBehavior default from collapse to link
- RecentNotes: fix limit default from 5 to 3, add hideTagPages/hideFolderPages
- StackedPages: fix option names to match source (maxTabs, not maxPanes)
2026-05-22 20:07:47 +02:00

2.4 KiB
Raw Blame History

title, tags, image
title tags image
StackedPages
plugin/component

Andy Matuschak-style stacked pages (sliding panes). Clicking internal links opens pages side by side in a horizontal stack, allowing you to trace your path through your notes. Each pane shows a full page and can be individually scrolled or closed.

Note

For information on how to add, remove or configure plugins, see the configuration#Plugins page.

Usage

Once enabled, clicking any internal link on a page opens the linked page as a new pane to the right instead of navigating away. The URL updates with a #stacked=slug1,slug2 hash encoding your current stack, so you can share or bookmark a specific trail of pages.

Stacked pages are disabled on mobile by default (below 800px) since horizontal panning doesn't work well on small screens. On mobile, links navigate normally.

Interactions

  • Click a link: Opens the target page in a new pane to the right. If the maximum number of panes is reached, the leftmost pane is removed.
  • Close a pane: Click the × button in the pane header to remove it from the stack.
  • Collapsed spines: When panes overflow the viewport, earlier panes collapse to a thin vertical spine showing the page title. Click a spine to bring that pane back into focus.
  • Browser back/forward: The full stack state is stored in the URL hash and integrated with browser history, so back/forward navigation works as expected.

Configuration

This plugin accepts the following configuration options:

  • maxTabs: Maximum number of stacked panes visible at once. Defaults to 8.
  • mobileBreakpoint: Viewport width (in pixels) below which stacked pages are disabled and links navigate normally. Defaults to 800.
  • showSpines: Whether to show collapsed spine headers when panes overflow the viewport. Defaults to true.
  • animateTransitions: Whether to animate pane open/close transitions. Defaults to true.

Default options

- source: github:quartz-community/stacked-pages
  enabled: true
  layout:
    position: afterBody
    priority: 50
    display: all
  options:
    maxTabs: 8
    mobileBreakpoint: 800
    showSpines: true
    animateTransitions: true

API

  • Category: Component
  • Function name: ExternalPlugin.StackedPages().
  • Source: quartz-community/stacked-pages
  • Install: npx quartz plugin add github:quartz-community/stacked-pages