MyST Document Engine Releases

Release notes for the MyST Document Engine (mystmd).

mystmd@1.10.1¶

2026-06-05 | View release

(full changelog)

Enhancements made

• Revert thebe #2903 (@choldgraf, @rowanc1)

mystmd@1.10.0¶

2026-06-04 | View release

(full changelog)

Enhancements made

• Accept myst.yaml as an alternative to myst.yml #2884 (@stefanv, @choldgraf, @rowanc1, @yuvipanda)

• Only copy thebe JS when necessary #2878 (@stefanv, @choldgraf, @rowanc1)

• Add option to specify static files for site builds #2770 (@stefanv, @RRiva, @agoose77, @choldgraf, @cycomachead, @espg, @rowanc1)

• 🃏 Wrap card in a passthrough typst function, that can be redefined by the user #2640 (@jan-david-fischbach, @rowanc1, @stefanv)

Bugs fixed

• 🐛 Citation @mention followed by html parsing bug #2891 (@rowanc1, @stefanv)

• Add kernel startup timeout and retry + choose open port on execute #2874 (@choldgraf, @rowanc1, @stefanv)

• Add extra guidance around changesets and myst-cli bumping #2862 (@choldgraf, @rowanc1)

• fix(myst-cli): append index-redirect script to end of instead of prepending #2851 (@chad-earthscope, @choldgraf)

Maintenance and upkeep improvements

• Pin new tex-to-typst #2889 (@stefanv, @choldgraf, @rowanc1)

• Document deprecated projects config #2888 (@choldgraf, @rowanc1)

• Ignore ./worktrees dir in linting/formatting #2881 (@stefanv, @choldgraf, @rowanc1)

Documentation improvements

• Document the a11y workflow #2896 (@choldgraf, @stefanv)

• 📖 Document JupyterHub PDF export tools #2880 (@sgibler-droid, @choldgraf, @rowanc1)

• 📖 Clarify jtex frontmatter template fields #2879 (@sgibler-droid, @rowanc1)

• Document site options config w page frontmatter #2873 (@choldgraf, @cycomachead, @rowanc1, @stefanv)

• docs: clarify PDF export prerequisites #2867 (@sgibler-droid, @choldgraf)

• Add additional documentation for LaTeX PDFs #2806 (@Songtech-0912, @agoose77, @choldgraf, @cycomachead, @schmoelder)

mystmd@1.9.1¶

2026-05-20 | View release

(full changelog)

Bugs fixed

• Await connection end for jupyter kernel #2853 (@choldgraf, @agoose77, @rowanc1)

Maintenance and upkeep improvements

• ✊ Bump mystmd to release #2858 (@rowanc1)

Documentation improvements

• Document dark mode logo #2856 (@stefanv, @choldgraf)

• 📝 Experience Report Template Issue #2848 (@rowanc1, @choldgraf, @stefanv)

• Update accessibility docs with links and simplify page #2845 (@choldgraf, @bsipocz)

mystmd@1.9.0¶

2026-05-01 | View release

This brings some quality of life improvements for users and fixes several under-the-hood bugs. You can now skip link-checking in --strict mode, which will improve performance significantly for documentation sites with many links!

Enhancements made

• Don’t check links with strict mode #2819 (@choldgraf, @agoose77, @rowanc1)

• Exclude a few more TLDs from linkify #2796 (@choldgraf)

Bugs fixed

• :bug: Fix type of stop function #2841 (@agoose77)

• Await signals to terminate processes #2834 (@choldgraf, @agoose77, @ryanlovett)

• fix: in static builds, redirect index.html to canonical route for hydration #2825 (@stefanv, @choldgraf)

• 🐛 Reduce scope of citation tests for sept months #2823 (@rowanc1, @choldgraf)

• 🔧 fix exports when anywidgets are in containers #2810 (@stevejpurves, @agoose77)

Maintenance and upkeep improvements

• Expose content server with sockets on starting dev server #2827 (@stevejpurves, @agoose77)

Documentation improvements

• Fix typos and improve clarity in index.md #2837 (@engyrus, @choldgraf)

• Add banner to the documentation #2832 (@FreekPols, @choldgraf)

• Include CSS workaround for fixed image sizing #2826 (@FreekPols, @choldgraf)

• 📖 Developer Guide: Fixed typo on a sentence #2814 (@Polirecyliente, @agoose77)

• Document credit role more clearly #2807 (@choldgraf, @rowanc1)

• 📖 Install NodeJS guide: Removed unnecessary verb on a sentence #2798 (@Polirecyliente, @rowanc1)

• Clean up gitlab docs a bit #2794 (@FreekPols, @choldgraf)

mystmd@1.8.3¶

2026-04-01 | View release

(full changelog)

Enhancements made

• 🔌 Defer config-level part resolution until plugins are all loaded #2789 (@fwkoch, @agoose77, @choldgraf, @rowanc1, @stefanv)

• 🆕 Emit Node20 for mystmd #2783 (@agoose77, @choldgraf, @rowanc1)

• Support columns on grid-item directive #2766 (@stefanv, @agoose77, @choldgraf, @jarrodmillman)

• Add error kind icon to strict build report #2755 (@mfisher87, @rowanc1, @stefanv)

• 👨🏻‍💻 Allow code-cell directive to use code options #2745 (@choldgraf, @fwkoch, @rowanc1, @stefanv)

• Document folder and landing page behavior #2704 (@choldgraf)

• 🏷️ Render span identifiers as Typst labels #2698 (@luukfroling, @FreekPols, @rowanc1)

Bugs fixed

• 📺 Partially fix update of display data #2786 (@agoose77, @rowanc1)

• 🍞 Add bun to flake #2776 (@agoose77)

• Fix \string macro leaking its name into image filenames in tex-to-myst #2774 (@stefanv, @rowanc1)

• 🧹 Add typecheck to the mystmd client #2761 (@rowanc1)

• 🪟 Windows paths on upgrade, resolve paths correctly #2758 (@rowanc1, @agoose77)

• 🧹 Fix json type annotation in anywidget directive #2740 (@fwkoch)

Maintenance and upkeep improvements

• 🧪 Increase test timeout #2759 (@rowanc1, @agoose77, @stefanv)

• 🫓 npm to bun #2748 (@stefanv, @agoose77, @rowanc1)

• 🧪 Add names and a changeset to CICD action #2736 (@choldgraf, @rowanc1)

Documentation improvements

• Add documentation about gitlab #2792 (@FreekPols, @choldgraf)

• docs: Added missing preposition in sentence #2790 (@Polirecyliente, @Julian-Tovar, @agoose77)

• floating :::: breaking last part #2782 (@FreekPols, @rowanc1)

• 📖 Document how to upgrade the theme dependencies for mystmd.org #2739 (@choldgraf, @rowanc1)

• 📖 Document new package steps for developers and add changeset validation to PRs #2734 (@choldgraf, @rowanc1, @stefanv)

• 📖 Making text and example consistent #2732 (@bsipocz, @rowanc1)

mystmd@1.8.2¶

2026-03-03 | View release

This release adds experimental widget support via the new {anywidget} directive, letting you embed interactive JavaScript components in your MyST documents. The {toc} directive also gains a children context option for showing only child pages.

Enhancements made

• Add children context to toc directive #2705 (@choldgraf, @agoose77)

• ✨ Add {anywidget} directive and AST node #2602 (@stevejpurves, @agoose77, @choldgraf, @rowanc1)

Bugs fixed

• Fix bug by adding multi-line to role parsing #2725 (@choldgraf, @agoose77)

• :globe_with_meridians: Use v2 ROR API #2718 (@agoose77, @choldgraf)

• 🖊️ Separate references into paragraphs when exporting to docx #2699 (@cmarmo, @agoose77)

Maintenance and upkeep improvements

• :package: Bump Node.js version minimum #2716 (@agoose77, @choldgraf, @rowanc1)

• Change get_baseurl to match naming conventions #2713 (@yuvipanda, @rowanc1)

Documentation improvements

• Document corresponding author behavior #2730 (@choldgraf, @rowanc1)

• Rename anywidget document #2721 (@agoose77)

mystmd@1.8.1¶

2026-02-13 | View release

(full changelog)

This brings in several bugfixes to improve the UX around document parts and citation labels.

Enhancements made

• Add support for remote parts #2687 (@choldgraf, @agoose77, @stefanv)

Bugs fixed

• Fix URL generation bug in toc directive #2702 (@choldgraf, @rowanc1)

• Fix extends configuration with parts #2690 (@choldgraf, @agoose77)

• Make citation parsing less aggressive #2684 (@choldgraf, @rowanc1, @stefanv)

Documentation improvements

• Document more toc functionality #2686 (@choldgraf, @bsipocz)

• Document toc directive #2672 (@choldgraf, @stefanv)

• 📖 Update release process for ‘mystmd’ to include PyPI and Conda #2667 (@rowanc1, @choldgraf)