Summary display
The summary display stacks cards that show the full description.
Each card shows the linked title, a meta line with the date and author(s), the description, and a tags row, with the thumbnail (if any) floated to the right.
It suits reading lists and blog indexes, where the full text matters more than the image.
The meta line combines date and author(s).
Authors come from an author (a single name) or authors (a list) frontmatter field.
Note: an id that references a project author is not yet supported, see myst
A summary from local files¶
:::{listing}
:path: posts/*.md
:display: summary
:::Highlights from the community call — new contributors, three plugins in the works, and a roadmap for the next release cycle.
A step-by-step guide to your first listing, from a bare directive to a styled gallery.
Interactive widgets have landed. Embed live, manipulable figures directly in your pages — sliders, toggles, and plots that respond to readers — without writing a single line of JavaScript yourself.
The Zebra release is out — faster builds, a redesigned gallery, and a long list of bug fixes contributed by the community.
What happened in February — a roundup of fixes, docs improvements, and the first community contributions to land.
The very first post — what this project is, why we started it, and where we hope to take it over the coming year.
A look back at the very first prototype — what worked, what didn't, and the rough edges we sanded down before the public launch.
Filter it live¶
Every item carries a myst-listing-item class, so the searchfilter plugin can filter the cards as you type — it matches against everything in each card (title, tags, date, description):
:::{searchfilter} .myst-listing-item
:::
:::{listing}
:path: posts/*.md
:display: summary
:::Highlights from the community call — new contributors, three plugins in the works, and a roadmap for the next release cycle.
A step-by-step guide to your first listing, from a bare directive to a styled gallery.
Interactive widgets have landed. Embed live, manipulable figures directly in your pages — sliders, toggles, and plots that respond to readers — without writing a single line of JavaScript yourself.
The Zebra release is out — faster builds, a redesigned gallery, and a long list of bug fixes contributed by the community.
What happened in February — a roundup of fixes, docs improvements, and the first community contributions to land.
The very first post — what this project is, why we started it, and where we hope to take it over the coming year.
A look back at the very first prototype — what worked, what didn't, and the rough edges we sanded down before the public launch.