MyST Theme v0.18.0 - November 24th, 2025

Release Source

This brings a number of improvements to UI components and flexibility for the book theme, and also adds human-level classes so that users can style things more easily with their own stylesheets!

Enhancements made¶

• 🥢 Add human-readable CSS classes to theme elements for easier styling #667 (@ayghri, @artoftheblue, @choldgraf, @netlify, @stefanv, @stevejpurves)

• Add customizable banner component #675 (@choldgraf, @agoose77, @netlify, @stefanv)

• add hide_authors option #674 (@agoose77, @netlify, @stevejpurves)

• 🪐 Remove Jupyter Logo from frontmatter #670 (@rowanc1, @bsipocz, @choldgraf, @netlify)

• 👣 Allow custom primary sidebar footer #613 (@artoftheblue, @agoose77, @choldgraf, @netlify, @stefanv)

• 🖼️ Consume title in IFrame renderer #694 (@agoose77, @choldgraf, @netlify, @stefanv, @stevejpurves)

• 🧩 Pull parts from site as well as project for banner and footer #685 (@agoose77, @choldgraf, @netlify)

• 🫳 Adjust PrimarySideBar downwards when banner is visible #683 (@stefanv, @agoose77, @choldgraf, @netlify)

• 🔐 Improve security for localhost #646 (@rowanc1, @netlify)

• Add aria-label for DocumentOutline.tsx dropdown button #641 (@kevinlin1, @agoose77, @netlify, @stevejpurves)

Bugs fixed¶

• FIX: Whitespace for checkboxes #686 (@choldgraf, @netlify, @stefanv, @stevejpurves)

• Re-fix bug for hidden play button #673 (@choldgraf, @agoose77, @netlify)

• Add baseurl to the sidebar links #671 (@choldgraf, @agoose77, @netlify, @rowanc1)

• Fix document outline overflowing off the screen #665 (@mfisher87, @agoose77, @choldgraf, @netlify)

• Fix accessibility bugs in search form dialog #656 (@kevinlin1, @agoose77, @netlify)

• Increase search bar text contrast #655 (@kevinlin1, @agoose77, @netlify)

• Add missing base URLs in top navigation #644 (@kevinlin1, @agoose77, @netlify)

• :beetle: :boom: Fix static html sidebar nav menu collapse bug #647 (@brianhawthorne, @agoose77, @netlify, @rowanc1, @stefanv)

• ⌨️ Cell block overflow color and copy icon location #627 (@rowanc1, @matthewfeickert, @netlify)

• 🐬 Flip main and article elements #586 (@agoose77, @choldgraf, @netlify, @rowanc1, @stevejpurves)

Maintenance and upkeep improvements¶

• Add manual netlify command #701 (@choldgraf, @netlify, @stefanv)

• Fix banner link #696 (@stefanv, @agoose77, @bsipocz, @choldgraf, @netlify, @stevejpurves)

• ⚠️ Show warning when CSS fails to apply #693 (@agoose77, @choldgraf, @netlify)

• 🧜‍♀️ Upgrade mermaid to ^11 #658 (@agoose77, @netlify, @stefanv)

• 🐛 Remove the misleading “Slack notification” in the release action #630 (@rowanc1, @netlify)

• 🐛 seealse --> seealso #629 (@rowanc1, @netlify)

Documentation improvements¶

• Delete visual reference #691 (@choldgraf, @netlify)

• Add kitchen sink reference #690 (@choldgraf, @bsipocz, @netlify, @stefanv)

• Reformat main #688 (@stefanv, @netlify)

• Add a logo and title to the myst-theme docs #681 (@choldgraf, @netlify)

• Update developer guide #678 (@choldgraf, @netlify, @stefanv)

• Add bokeh example #619 (@choldgraf, @netlify, @rowanc1)

• Document a few more theme features #700 (@choldgraf, @bsipocz, @netlify)

Contributors to this release¶

The following people contributed discussions, new ideas, code and documentation contributions, and review. See our definition of contributors.

(GitHub contributors page for this release)

@acocac (activity) | @agoose77 (activity) | @artoftheblue (activity) | @ayghri (activity) | @brianhawthorne (activity) | @bsipocz (activity) | @choldgraf (activity) | @fperez (activity) | @kevinlin1 (activity) | @matthewfeickert (activity) | @mfisher87 (activity) | @netlify (activity) | @parmentelat (activity) | @rowanc1 (activity) | @stefanv (activity) | @stevejpurves (activity)