Welcome to myst-contrib — a community-maintained home for projects that extend, customize, and improve the MyST Markdown and Jupyter Book ecosystems. This organization is a space where contributors can develop, share, and steward plugins, templates, themes, and other tools that make MyST more powerful for everyone.
If you’re new to MyST, start with the MyST documentation and the Jupyter Book project. To learn how MyST can be extended, see the plugin guide.
What lives here?¶
The myst-contrib organization is a home for community-curated projects that complement the core MyST infrastructure. You’ll find:
🧩 Plugins — directives, roles, and transforms that add new behavior to MyST documents. Learn how to author a plugin.
📄 Templates — LaTeX, Typst, and Word templates for exporting MyST documents to typeset, formatted outputs. See the templates guide.
🎨 Themes — site themes that change how MyST websites look and feel. See themes.
🧪 Prototypes & experiments — early-stage projects exploring new ideas that may one day move into the core MyST tooling.
🛠️ Tools & integrations — utilities that connect MyST to other parts of the publishing and scientific computing ecosystem.
This organization complements jupyter-book, which hosts the core MyST infrastructure (e.g. mystmd, myst-theme, jupyter-book). Projects here may receive lighter maintenance from the core team, but are visible, discoverable, and open to community contribution.
Why donate a project to myst-contrib?¶
If you’ve built something useful for the MyST community and you’d like to give it broader visibility — myst-contrib is a great home. Donating your repository to this org means:
It lives in a community-maintained space.
It gets visibility through this profile and the broader MyST ecosystem.
It can be collaboratively maintained by other community members.
It can be a stepping stone for ideas that may eventually move into the core MyST tooling.
If you’d like to donate a project, please open an issue and we’ll help coordinate the transfer.
Contributing¶
We welcome contributions of all kinds — new plugins, templates, themes, bug fixes, documentation improvements, or feedback. To get started:
📝 Open an issue — tell us about an idea, a project you’d like to donate, or a problem you’ve run into.
🧩 Build a plugin — extend MyST with custom directives, roles, and transforms.
📄 Create a template — add support for a new journal, conference, or output format.
🤝 Contribute to an existing project — find a repository that interests you and dive in.
All contributors are expected to follow the MyST community Code of Conduct.
Get in touch¶
💬 MyST discussions — ask questions and share what you’re working on.
🌐 mystmd.org — official MyST documentation.
📣 Team compass — how the MyST and Jupyter Book community is organized.