Sections display
The sections display renders each item as a real section of the page: an ##-level heading per item, so every item shows up in the page’s table of contents and can be deep-linked.
It suits pages that are the listing: release notes, a one-page changelog, or combined meeting notes where each meeting had its own page originally.
Each section shows the title as a plain heading, a muted date · author line, tags, and the item’s full body.
Body headings are demoted to bold text without anchors (as in feed), so a long changelog doesn’t flood the page outline.
A changelog with an outline¶
Each release below is a section, and the page outline on the right lists them:
:::{listing}
:path: ../posts/*.md
:filter: tags=release
:display: sections
:::Interactive widgets¶
Interactive widgets let you embed live, manipulable figures directly in your pages. Readers can drag a slider or toggle a series and watch the figure respond, with no JavaScript on your part.
Widgets work anywhere a figure does, including inside grids. They fall back to a static image when scripting is unavailable.
Zebra release notes¶
Zebra is our biggest release yet, focused on build speed and the gallery display. Upgrade with your usual package manager; no configuration changes are required.
A redesigned gallery with responsive columns and even card heights.
Per-field tag colors, so you can show more than one kind of tag at a glance.
A redundant re-parse that slowed large projects; builds are roughly twice as fast.
Thumbnails with transparent backgrounds now stay legible in dark themes.
Several smaller layout glitches on narrow screens.
The first prototype¶
Where this all started.
Filter it live¶
Each item carries the same myst-listing-item class as the other displays, so searchfilter works here too:
:::{searchfilter} .myst-listing-item
:::
:::{listing}
:path: ../posts/*.md
:display: sections
:limit: 3
:::Community roundup¶
Our latest community call was the busiest one yet. Here are the highlights from a packed hour of demos and discussion.
Five new contributors landed their first pull requests this month.
Three plugins are in the works, including a GitHub-releases collector.
We sketched a roadmap for the next release cycle, with a focus on accessibility.
Thanks to everyone who joined. The next call is on the first Thursday of the month.
Your first listing¶
Start here if you’re new.
Interactive widgets¶
Interactive widgets let you embed live, manipulable figures directly in your pages. Readers can drag a slider or toggle a series and watch the figure respond, with no JavaScript on your part.
Widgets work anywhere a figure does, including inside grids. They fall back to a static image when scripting is unavailable.