MyST Markdown

MyST Markdown

@mystmd.org

Markdown with superpowers for writing scientific 👨‍🔬 and technical 📈papers. #OpenSource & maintained by Project #Jupyter.

1.2K followers3.7K following81 posts

MyST Markdown reposted

🚀 Today we’re launching Curvenote Reader Curvenote Reader transforms existing research into connected, web-native reading experiences layered onto the systems repositories and publishers already use. No rebuilds. No workflow disruption. → curvenote.com/products/rea...

MyST Markdown reposted

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...

opensci.devUpstreaming `anywidget` into the MyST Markdown core - opensci.devA techbit on upstreaming the anywidget directive to the MyST Markdown core stack, enabling first-class support for embedding JS widgets in MyST Markdown documents.

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.

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. 🎉

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

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...

github.com✍️ Parse Markdown and LaTeX outputs into AST by agoose77 · Pull Request #1961 · jupyter-book/mystmdThis 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...

MyST Markdown reposted

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...

github.comcurvenote/packages/any-widget at main · curvenote/curvenoteCreate, edit, share, and publish scientific and technical documents. - curvenote/curvenote

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.

proceedings.scipy.orgJupyter Book 2 and the MyST Document Stack - SciPy ProceedingsJupyter 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…

MyST Markdown reposted

MyST Markdown reposted

MyST Markdown reposted

The @mystmd.org theme now has support for "page edit" buttons! These take you directly to the source page in GitHub so that you can quickly make an edit. They are so useful! Many thanks to Kira for getting this in with her first contribution to the MyST Theme! github.com/jupyter-book...

github.com✍️ Feat: add edit button by kne42 · Pull Request #577 · jupyter-book/myst-themeAdds an edit button to pages that have GitHub repo information to edit the corresponding page on the site. closes #326

MyST Markdown reposted

MyST Markdown reposted

New MyST proposal! It's for a short-hand way to add classes/options/labels to roles and directives. Read and comment here: github.com/jupyter-book... This will unlock a lot of functionality for extending roles in particular, I'm really excited about it! (led by @row1.ca and @agoose77.bsky.social)

github.comInline Options for Roles and Directives by agoose77 · Pull Request #28 · jupyter-book/myst-enhancement-proposalsThis is a WIP draft for adding "inline attributes" to MyST. Spec Issue: jupyter-book/myst-spec#68

MyST Markdown reposted

MyST Markdown reposted

Still science in 2024: "Our figure 2 shows this result clearly. Please scroll down 30 PAGES to see it..." PS with @curvenote.com journals, inline figures can go full-width, and any reference to a figure shows it in a hover popup.

Michael Andrades@michaelandrades.bsky.social

Why do journals insist on requiring figures at the end of the file? Haven't editors reviewed enough manuscripts to realize it's much easier to check a fig. when it's near the paragraph where it is cited? Make reviewers' lives easier - you're already not paying them! #ScientificPublishing #PeerReview

MyST Markdown reposted