MyST Document Engine Releases

Release notes for the MyST Document Engine (mystmd).

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)

mystmd@1.7.0¶

2025-12-04 | View release

(full changelog)

Enhancements made

• 🤖 Update our TS config and bundler versions #2499 (@agoose77, @rowanc1, @changeset-bot)

• 🤖 Store execution outputs in Outputs #1903 (@agoose77, @stevejpurves, @rowanc1, @changeset-bot, @fwkoch, @stefanv)

Bugs fixed

• 🐛 Latex tables without containers #2536 (@rowanc1, @changeset-bot, @stefanv)

• 🐛 Do not raise errors on non-accessible sub-trees #2532 (@rowanc1, @choldgraf, @changeset-bot)

Maintenance and upkeep improvements

• 🐛 Incorrect type import #2541 (@rowanc1, @changeset-bot)

• 📦 Packaging updates #2539 (@rowanc1, @changeset-bot)

• Add npm verb to quickly demo docs #2516 (@choldgraf, @rowanc1, @changeset-bot)

Documentation improvements

• 📖 Fix typo in GitHub Pages documentation #2550 (@asjohnston-asf, @rowanc1, @stefanv, @changeset-bot)

• 📖 Deploy all docs in automation #2528 (@rowanc1, @changeset-bot)

• 📖 Enhance deployment.md with BASE_URL examples #2510 (@FreekPols, @rowanc1, @akhmerov, @changeset-bot)

• Advice on how to grep myst codebase #2488 (@stefanv, @rowanc1, @changeset-bot)

mystmd@1.6.7¶

2025-12-01 | View release

(full changelog)

Enhancements made

• 🔑 Support keys for DOI links #2492 (@rowanc1, @mfisher87, @stefanv, @changeset-bot)

• Add support for notebook cell output scroll metadata #2433 (@choldgraf, @agoose77, @changeset-bot, @bsipocz)

Bugs fixed

• 🐛 Footnote and role parsing bug #2525 (@rowanc1, @changeset-bot)

• 🐛 Don’t crash if links don’t have URLs #2518 (@rowanc1, @changeset-bot)

• 🗺️ Fetch sitemap when building static site #2450 (@agoose77, @changeset-bot)

• 🧹 Remove hide_authors handling #2420 (@agoose77, @choldgraf, @stefanv, @changeset-bot)

Maintenance and upkeep improvements

• 📖 Trigger docs build with release workflow #2519 (@choldgraf, @rowanc1, @changeset-bot)

Documentation improvements

• slight improvements in docs on configuration / frontmatter #2521 (@parmentelat, @choldgraf, @changeset-bot)

• 📖 Make the myst-transform doc smoother and more legible #2520 (@parmentelat, @rowanc1, @changeset-bot)

• Add plugin use case and debugging docs #2515 (@mfisher87, @choldgraf, @changeset-bot)

• Add documentation to {myst} directive #2508 (@mfisher87, @agoose77, @changeset-bot)

• Provide explicit debug command in error rules documentation #2494 (@mfisher87, @stefanv, @changeset-bot)

• 📖 Add subsection about document titles in TOC #2484 (@rossbar, @rowanc1, @stefanv, @changeset-bot)

• ⚙️ Update webserver deploy documentation #2479 (@akhmerov, @agoose77, @changeset-bot)

• Update site options docs for clarity #2468 (@choldgraf, @stefanv, @changeset-bot)

• Update OpenAlex API link in frontmatter documentation #2467 (@akhmerov, @choldgraf, @changeset-bot)

• Fix typo #2465 (@ofek, @choldgraf, @changeset-bot)

• Document how to use options with dashes in their names #2463 (@stefanv, @choldgraf, @changeset-bot)

• Update documentation for MyST HTML option #2462 (@akhmerov, @choldgraf, @stefanv, @changeset-bot)

Other merged PRs

• chore: add changeset #2513 (@agoose77, @changeset-bot, @stefanv, @rowanc1)

mystmd@1.6.6¶

2025-11-19 | View release

(full changelog)

Bugs fixed

• Fix execution bug: no need for kernelspec if no executable content #2454 (@choldgraf, @stefanv, @changeset-bot)

Other merged PRs

• Pull in latest myst-execute #2456 (@stefanv, @changeset-bot)

mystmd@1.6.5¶

2025-11-18 | View release

(full changelog)

Enhancements made

• 🖼️ Add support for iframe title. #2437 (@ryanlovett, @agoose77, @stefanv, @stevejpurves, @choldgraf)

• 🧪 Add mhchem extension #2418 (@rowanc1, @agoose77)

• 🚢 Enable port option for the builder #2409 (@agahkarakuzu, @fwkoch)

• 🪧 Add message for using Jupyter Book < 1 to upgrade #2390 (@choldgraf, @rowanc1)

• ✊ Add environment dependence for cache keys (etc.) to myst build --execute #2387 (@agoose77, @bsipocz, @choldgraf, @rowanc1)

Bugs fixed

• 🔠 Always set term label from {term} #2346 (@agoose77, @fwkoch, @rowanc1)

Maintenance and upkeep improvements

• 🤖 Stop over-eager documentation labeling #2417 (@fwkoch, @stefanv)

• 🧪 Add node 24 to ci testing #2410 (@fwkoch, @agoose77)

Documentation improvements

• 📚 Adjust external xref docs #2412 (@fwkoch, @agoose77)

• Update the plugins admonition to be a little more nuanced #2403 (@choldgraf, @agoose77)

• 📖 Add a link to the numbered citations #2402 (@rowanc1, @matthewfeickert)

• Doc exec build improved #2396 (@parmentelat, @choldgraf, @stefanv)

• :blue_book: Document static theme development #2309 (@brianhawthorne, @stefanv, @choldgraf)

• Make settings configuration more discoverable #2237 (@choldgraf, @bsipocz, @agoose77)

mystmd@1.6.4¶

2025-11-03 | View release

(full changelog)

Enhancements made

• ⚠️ Improve {doc} role warning with node position #2375 (@rowanc1, @changeset-bot, @mfisher87)

• 🐛 Log errors on watch #2355 (@rowanc1, @changeset-bot)

Bugs fixed

• 🪟 Windows-path for toc #2389 (@rowanc1, @agoose77, @fwkoch, @changeset-bot)

• 🖼️ Ensure favicon is under site.options #2359 (@rowanc1, @changeset-bot)

• 🐛 Undefined URLs can cause errors #2356 (@rowanc1, @changeset-bot)

• 🛠️ Bring MarkdownIt version consistently in-line internally #2323 (@agoose77, @rowanc1, @changeset-bot)

• 🔗 Resolve links and image paths relative to project root if they starts with / #2217 (@fk128, @fwkoch, @changeset-bot, @agoose77, @mfisher87, @rowanc1)

Maintenance and upkeep improvements

• 🪜 Unescape yaml for labeler action #2349 (@agoose77, @changeset-bot, @rowanc1)

Documentation improvements

• Add executable Python examples for navigating and scraping MyST sites #2378 (@choldgraf, @stefanv, @changeset-bot)

• 📖 Formatting bug in docs, and improve admonition page #2358 (@rowanc1, @changeset-bot)

• 🐛 Caption does not exist on list-table #2357 (@rowanc1, @changeset-bot)

mystmd@1.6.3¶

2025-10-10 | View release

(full changelog)

Enhancements made

• 🔎 Set HOST environment variable to 127.0.0.1 on ReadTheDocs CI #2313 (@rowanc1, @changeset-bot)

• 🧮 Allow math in numbering as an alias for equation #2311 (@rowanc1, @changeset-bot)

Bugs fixed

• 🐛 Include index page in --strict mode error checking #2331 (@rowanc1, @changeset-bot, @bsipocz)

• ✍️ Improvements for typst exports #2330 (@fwkoch, @rowanc1, @changeset-bot)

• 🤐 Show an error when the myst.xref.json fails to load #2329 (@rowanc1, @changeset-bot)

• 🔑 Add --keep-host to build command #2305 (@rowanc1, @changeset-bot)

Maintenance and upkeep improvements

• 📦 tex-to-typst v0.0.18 #2339 (@fwkoch, @changeset-bot)

• 🏷️ Add autolabeler rules #2326 (@agoose77, @changeset-bot, @bsipocz)

• 📦 Updates to build packages (typescript, esbuild, vite, nanoid) #2314 (@rowanc1, @changeset-bot)

• 📦 Update @jupyterlab/services lockfile pin #2297 (@agoose77, @rowanc1, @bsipocz, @changeset-bot)

• :wrench: Refactorings to clean up table-of-contents transform #2181 (@brianhawthorne, @fwkoch, @changeset-bot)

Documentation improvements

• 📖 xref directives syntax on directives list page #2337 (@bsipocz, @fwkoch, @changeset-bot)

• 📖 Adding xref error rules in cli docs #2335 (@bsipocz, @rowanc1, @changeset-bot)

• 🔗 Ignore patterns for links #2334 (@rowanc1, @fwkoch, @changeset-bot)

• 📖 Add default severity for RuleIds to the docs #2333 (@rowanc1, @fwkoch, @bsipocz, @changeset-bot)

• 📖 Document error rules #2332 (@rowanc1, @changeset-bot)

• 🗓️ Add quotes for dates #2324 (@bsipocz, @agoose77, @changeset-bot)