MyST Markdown's Avatar

MyST Markdown

@mystmd.org

Markdown with superpowers for writing scientific πŸ‘¨β€πŸ”¬ and technical πŸ“ˆpapers. #OpenSource & maintained by Project #Jupyter.

1,202
Followers
3,797
Following
80
Posts
01.08.2023
Joined
Posts Following

Latest posts by MyST Markdown @mystmd.org

Video thumbnail

Made some #bluesky profile cards for @mystmd.org via the widget interface (widget doesn't feel like right interface, but a handy starting point). Just needed a fetch call to api.bsky.app 🀩 wrote more about it here. more #bsky / #atproto experiments coming.

opensci.dev/articles/blu...

21.02.2026 09:20 πŸ‘ 5 πŸ” 4 πŸ’¬ 1 πŸ“Œ 0
MyST Theme Releases - Community Guide This may be due to an incorrect BASE_URL configuration. See the MyST Documentation for reference.

New release πŸš€

We just shipped several UX and UI bugfixes in the Jupyter Book and MyST stack.

- mystmd v1.8.1 jupyterbook.org/releases/mys...
- myst-theme v1.1.2 jupyterbook.org/releases/mys...

We will get a jupyter-book release out to bring these in as soon as we fix our release infra πŸ˜…

16.02.2026 15:01 πŸ‘ 5 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

πŸ’šπŸš€

06.02.2026 13:32 πŸ‘ 0 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0
Preview
Upstreaming `anywidget` into the MyST Markdown core - opensci.dev A techbit on upstreaming the anywidget directive to the MyST Markdown core stack, enabling first-class support for embedding JS widgets in MyST Markdown documents.

Adding an `anywidget` style/based directive & renderer into the core @mystmd.org stack is a big win for custom interactivity and extensibility.

My contribution this week: to round off the first cut implementation - based on what've had in prod at @curvenote.com.

opensci.dev/articles/ups...

06.02.2026 10:12 πŸ‘ 6 πŸ” 3 πŸ’¬ 1 πŸ“Œ 0
Preview
Release myst-to-react@1.1.1 Β· jupyter-book/myst-theme This brings in several UI and UX improvements that were noticed after the last minor release! Bugs fixed Hover preview cards to documents with metadata now work! #772 (@choldgraf, @bsipocz, @rowan...

πŸ›³οΈ New release of myst-theme ! This is a patch release to fix a bunch of UI/UX bugs that we uncovered after the last minor release. Thanks to everybody for testing and quick feedback!

github.com/jupyter-book...

29.01.2026 20:42 πŸ‘ 2 πŸ” 2 πŸ’¬ 0 πŸ“Œ 1

This release was created by a community of maintainers, thanks to the Jupyter Book community for all of their support of the project! Check out the release notes above for a list of the people that contributed to each release. πŸŽ‰

27.01.2026 16:58 πŸ‘ 0 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0

It also standardizes and improves the behavior of links so that interactive, external, and internal links now have distinct and consistent styles so that your readers know what to expect.

27.01.2026 16:58 πŸ‘ 0 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0

This release brings more control over *concurrent execution* of notebook content as part of this build process. This allows you to define the number of simultaneous executions when your book builds to ensure they occur more sequentially, or reduce bugs if notebooks spawn their own parallel processes

27.01.2026 16:58 πŸ‘ 1 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0
Preview
Release mystmd@1.8.0 Β· jupyter-book/mystmd 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...

We're proud to announce a new release of the Jupyter Book stack! This brings in a number of fixes and UI improvements! Check out release notes for each here:

mystmd 1.8: github.com/jupyter-book...
myst-theme 1.1: github.com/jupyter-book...
jupyter-book 2.1.1: github.com/jupyter-book...

27.01.2026 16:57 πŸ‘ 8 πŸ” 3 πŸ’¬ 1 πŸ“Œ 1
JupyterHub + MyST: A Proxy Problem - opensci.dev A post exploring the proxy problem with JupyterHub and MyST Markdown's live previews.

Running live previews with the @mystmd.org CLI on a JupyterHub has been a challenge so far - the available theme servers are not setup well to support this. We've made progress on a solution that's almost ready to share, meantime this explains the problems it solves:

opensci.dev/articles/jup...

20.01.2026 21:07 πŸ‘ 2 πŸ” 2 πŸ’¬ 0 πŸ“Œ 1
Preview
Introducing the `page-last-updated` plugin - Jupyter Book: Blog Updates from the Jupyter Book subproject.

The page-last-updated plugin is a MyST plugin to make it clear to readers when your content was updated on each page. Here's a little post about how it works and where to learn about more plugins like it!

blog.jupyterbook.org/posts/2026/p...

14.01.2026 15:03 πŸ‘ 1 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0
Preview
On the MyST Markdown V3 AST - opensci.dev A post exploring the new MyST Markdown V3 AST and the changes it brings to the MyST Markdown stack.

I (and we @mystmd.org) have been working on releasing new version of the MyST Markdown AST. A foundational change to the representation of Jupyter outputs that sets up a lot of future possibilities - notes and thoughts are here: opensci.dev/articles/on-...

17.12.2025 08:50 πŸ‘ 9 πŸ” 4 πŸ’¬ 0 πŸ“Œ 0
Preview
✍️ Parse Markdown and LaTeX outputs into AST by agoose77 · Pull Request #1961 · jupyter-book/mystmd This PR closes #2114 by parsing Markdown and LaTeX outputs into the MyST AST. NotePart of initiative #1026 We skip the following transforms: importMdastFromJson includeFilesTransform rawDirective...

This lays the foundation for building more enriched and precise workflows around notebook outputs. We now treat *each output* from a cell independently, laying a foundation to enable things like generating labels with notebook cells.

Here's a PR to follow along:

github.com/jupyter-book...

17.12.2025 18:19 πŸ‘ 2 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0
Preview
πŸͺ Per-Output AST Representation for Code Cell Outputs by rowanc1 Β· Pull Request #32 Β· jupyter-book/myst-enhancement-proposals Extend the MyST AST to represent individual code cell outputs as separate AST nodes, enabling output content to participate in MyST builds (e.g., generate and consume reference labels). Authors @...

There's an ongoing community discussion about this change, and we invite feedback from others in this MyST Enhancement Proposal discussion:

github.com/jupyter-book...

17.12.2025 18:19 πŸ‘ 2 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0
Jupyter Book V3 AST: Better Output Handling and Future Possibilities - Jupyter Book: Blog Updates from the Jupyter Book subproject.

The Jupyter Book team has been working hard on a big foundational improvement to how notebook outputs are represented in MyST documents. Steve writes about this change and what it means in this post:

blog.jupyterbook.org/posts/2025-1...

17.12.2025 18:19 πŸ‘ 4 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0
Preview
curvenote/packages/any-widget at main Β· curvenote/curvenote Create, edit, share, and publish scientific and technical documents. - curvenote/curvenote

We've just moved our `any-widget` based directives and renders for @mystmd.org into a public repo on @curvenote.com . After quite a while tinkering these are nicely supporting interactive visualizations - more work to fully implement the full `any-widget` interface coming

github.com/curvenote/cu...

02.12.2025 09:41 πŸ‘ 4 πŸ” 3 πŸ’¬ 0 πŸ“Œ 0
Preview
πŸ–ΌοΈ Gallery of Jupyter Books - Jupyter Book Jupyter Book technology has been applied across a wide range of use cases, including curricula vitae, official educational textbooks, student portfolios, lab manuals, and technical documentation.…

The Jupyter Book gallery is back! Now with the MyST Engine under the hood! Thanks to @FreekPols for contributing it.

jupyterbook.org/latest/galle...

21.11.2025 18:39 πŸ‘ 6 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
Why we made a major release for Jupyter Book 2 instead of creating a new package - Jupyter Book: Blog Updates from the Jupyter Book subproject.

We recently pushed Jupyter Book 2, which was a breaking change for many of our users! We considered publishing a completely different package (e.g., `jupyter-book2`) but decided against it. Here's a quick rationale why:

07.11.2025 18:16 πŸ‘ 7 πŸ” 4 πŸ’¬ 0 πŸ“Œ 0
Post image

JupyterBook 2 is released! This is now built on top of the @mystmd.org engine directly.

πŸš€

Please reach out on our GitHub discussions if you have any problems upgrading.

03.11.2025 14:31 πŸ‘ 12 πŸ” 9 πŸ’¬ 1 πŸ“Œ 1

πŸš€πŸ’š

29.10.2025 21:14 πŸ‘ 0 πŸ” 0 πŸ’¬ 0 πŸ“Œ 0
Proceedings of SciPy 2025 - SciPy Proceedings Proceedings of the Python in Science Conferences

πŸš€ Exciting news! The SciPy 2025 Proceedings are officially published:
πŸ‘‰ proceedings.scipy.org/2025

Huge thanks to the Proceedings Committee, @curvenote.com, Jim Weiss, all the authors, and reviewers who made this happen. πŸ™Œ

29.10.2025 17:26 πŸ‘ 9 πŸ” 8 πŸ’¬ 2 πŸ“Œ 0
Post image

@creativecommons.bsky.social and @continuous.foundation are teaming up to make reuse the default for modular science.

Join the cohort working to shape incentives for reuse in modular science. The group will kick off in January 2026.

Apply by Sunday, Nov 30
continuousfoundation.org/reuse-form

28.10.2025 20:03 πŸ‘ 5 πŸ” 6 πŸ’¬ 1 πŸ“Œ 2
Preview
Jupyter Book 2 and the MyST Document Stack - SciPy Proceedings Jupyter Book allows researchers and educators to create books and knowledge bases that are reusable, reproducible, and interactive. This new foundation introduces a scalable way to publish…

We're excited to share the next step of this project, and invite you to join us in improving this ecosystem together!

πŸ“ Read the blog post: blog.jupyterbook.org/posts/2025-j...
πŸ“„ Read the paper πŸ‘‰ proceedings.scipy.org/articles/hwc...
✨ Try Jupyter Book 2 πŸ‘‰ next.jupyterbook.org

22.10.2025 14:02 πŸ‘ 1 πŸ” 1 πŸ’¬ 0 πŸ“Œ 0
Preview
Jupyter Book 2 and the MyST Document Stack - SciPy Proceedings Jupyter Book allows researchers and educators to create books and knowledge bases that are reusable, reproducible, and interactive. This new foundation introduces a scalable way to publish…

Combined with federated APIs and extensibility and modularity, Jupyter Book and MyST documents enable cross-project references, making scientific knowledge more interconnected.

22.10.2025 14:02 πŸ‘ 1 πŸ” 1 πŸ’¬ 1 πŸ“Œ 0
Preview
Jupyter Book 2 and the MyST Document Stack - SciPy Proceedings Jupyter Book allows researchers and educators to create books and knowledge bases that are reusable, reproducible, and interactive. This new foundation introduces a scalable way to publish…

We're also excited to lean into "content as structured data". MyST documents are represented as a structured abstract syntax tree (AST), making them canonical and machine-readable. This enables powerful transformations and remixing across projects.

22.10.2025 14:02 πŸ‘ 1 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0
Preview
Jupyter Book 2 and the MyST Document Stack - SciPy Proceedings Jupyter Book allows researchers and educators to create books and knowledge bases that are reusable, reproducible, and interactive. This new foundation introduces a scalable way to publish…

There are several core principles behind this project:

simple to use yet extensible
machine-readable content
modular & composable docs
federated APIs
computation as first-class content

22.10.2025 14:02 πŸ‘ 1 πŸ” 0 πŸ’¬ 1 πŸ“Œ 0
Preview
Jupyter Book 2 and the MyST Document Stack - SciPy Proceedings Jupyter Book allows researchers and educators to create books and knowledge bases that are reusable, reproducible, and interactive. This new foundation introduces a scalable way to publish…

🚨 New paper! The @jupyterbook.org team just published a peer-reviewed paper in the SciPy Proceedings describing the design & architecture of Jupyter Book 2 and the MyST Document Engine!

πŸ“ blog post: blog.jupyterbook.org/posts/2025-j...
πŸ“„ paper: proceedings.scipy.org/articles/hwc...

22.10.2025 14:02 πŸ‘ 8 πŸ” 3 πŸ’¬ 1 πŸ“Œ 0
Preview
Release mystmd@1.5.0 Β· jupyter-book/mystmd (full changelog) Enhancements made πŸ—Ύ HTML Image Width #2111 (@rowanc1, @changeset-bot) πŸ‘½ Handle external URL specified in TOC #2102 (@stefanv, @fwkoch, @choldgraf, @mfisher87, @rowanc1, @changeset...

@mystmd.org 1.5 is out, along with an updated web theme!

github.com/jupyter-book...

github.com/jupyter-book...

Improved site footers, hidden entries and external URLs in table of contents, better UI for in-browser execution plus improved docs and bug-fixes.

24.06.2025 22:33 πŸ‘ 11 πŸ” 2 πŸ’¬ 1 πŸ“Œ 0
Preview
Release mystmd v1.4.0 Β· jupyter-book/mystmd (full changelog) Enhancements made πŸ’¬ Add social media project frontmatter #2021 (@kne42, @agoose77, @fwkoch, @rowanc1, @choldgraf, @artoftheblue) Complete ipynb export support #1915 (@kp992, @agoo...

Release notes from the 1.4 release of @mystmd.org - the team made a bunch of improvements on social media links, plugin functionality, and documentation for contributors and developers!

github.com/jupyter-book...

13.06.2025 13:49 πŸ‘ 15 πŸ” 3 πŸ’¬ 0 πŸ“Œ 2
Overview of the MyST stack - MyST Markdown

A Jupyter Book team goal over the past months has been improving the documentation for users and contributors in the @mystmd.org project. I wanted to share two important pages with big updates!

A conceptual overview of MyST: mystmd.org/guide/overview

Our developer guide: mystmd.org/guide/develo...

25.05.2025 14:26 πŸ‘ 19 πŸ” 2 πŸ’¬ 1 πŸ“Œ 0