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)

mystmd@1.8.0¶

2026-01-21 | View release

This brings in new functionality for execution concurrency, allowing you to control how many notebooks are executed in parallel during build in case you have notebooks that depend on one another or spin up their own parallel kernele. Also added a number of stability improvements and quality of life features.

Enhancements made

• Allow users to define the number of simultaneous executions #2428 (@agahkarakuzu, @agoose77, @bsipocz, @choldgraf, @stefanv)

• Add CLI to generate ReadTheDocs configuration via myst init --readthedocs #2555 (@jtpio, @choldgraf, @mfisher87)

• Allow the API URL to be configured with an environment variable #2554 (@parmentelat, @agoose77)

• 🔐 Use npm ci instead of npm install for theme dependencies #2487 (@stefanv, @agoose77, @mfisher87, @stevejpurves)

• Update @preview/subpar for subfigures in typst export #2624 (@jan-david-fischbach, @rowanc1)

Bugs fixed

• Define edit_url as page and project frontmatter #2650 (@choldgraf, @agoose77, @rowanc1, @stefanv)

• Improve edit URL branch logic #2642 (@choldgraf, @agoose77, @rowanc1, @stefanv)

• β Remove ‘ß’ mapping from utils #2639 (@rowanc1, @choldgraf)

• Allow TOC to set short_title #2636 (@choldgraf, @bsipocz, @stefanv)

• FIX: formatting in developer.md for mermaid diagram #2619 (@jan-david-fischbach, @rowanc1)

• Add support for parsing decimal numbers in si role #2600 (@jan-david-fischbach, @rowanc1)

• Fix empty button role #2557 (@choldgraf, @agoose77, @stefanv)

Maintenance and upkeep improvements

• Add repository information for myst-transforms #2664 (@choldgraf)

• ⛘ Bring myst-spec into monorepo for further development #2584 (@rowanc1, @Carreau, @aktech, @boisgera, @choldgraf, @chrisjsewell, @fwkoch, @sglyon)

Documentation improvements

• Add pointer to MEP repo. #2588 (@ryanlovett, @agoose77)

• Add citation markdown formatting info to simple referencing with DOI Link #2651 (@TimMonko, @choldgraf)

• Minor spelling fix #2645 (@tylere, @choldgraf, @stefanv)

• 📖 Clarify that subtitle is also available in project configuration #2633 (@lucafrance, @rowanc1)

• Fix link #2632 (@lucafrance, @agoose77)

• an extra ‘The file’ forgotten at the end of line #2611 (@parmentelat, @agoose77)

• docs: update primary sidebar footer #2604 (@jnywong, @choldgraf)

• Clarify download documentation #2597 (@choldgraf)

• DOC: removing deprecated frontmatter from docs #2596 (@bsipocz, @agoose77, @choldgraf)

• fix typo in documentation of options #2587 (@brownsarahm, @rowanc1)

• Add a description of the theme server contract #2566 (@akhmerov, @agoose77, @choldgraf, @rowanc1)

• revisited doc on table of contents #2522 (@parmentelat, @bsipocz, @choldgraf)

• Update documentation on extends #2362 (@FreekPols, @choldgraf, @stefanv)

mystmd@1.7.1¶

2025-12-10 | View release

(full changelog)

Enhancements made

• ☑️ MyST-to-TeX: add support for checkboxes #2560 (@nthiery, @rowanc1)

• 🚛 migrate xrefs #2551 (@stevejpurves, @fwkoch, @rowanc1, @stefanv)

• ⏪ Support sort: ascending order on patterns in the table of contents #2546 (@rowanc1, @agoose77, @choldgraf, @mfisher87, @stefanv)

• 💰 Dollarmath settings for markdown parsing #2542 (@rowanc1)

Bugs fixed

• 🔑 Add key to avoid react error #2577 (@rowanc1)

• 🐛 Catch error states of chokidar #2543 (@rowanc1)

• 🛑 Kill process trees on Linux #2529 (@rowanc1, @akhmerov)

Maintenance and upkeep improvements

• 📦 Generalize the HTTP logger for the myst-cli #2574 (@rowanc1)

• 🧪 Remove short DOI test in latex #2572 (@rowanc1)

• 📦 Remove any in container #2571 (@rowanc1)

• 👮 Type check and type alignment #2561 (@stevejpurves, @rowanc1)

Documentation improvements

• Remove a confusing clarification #2564 (@akhmerov, @choldgraf)

• Improve documentation on making releases #2157 (@choldgraf)