Feature Idea – Run All mask Targets in a Markdown File

[fr12k]

Hi there 👋

First off, thank you for this awesome tool — it's been great to work with! 🙌

We're exploring an interesting use case and wanted to share our thoughts to see if it's something that could be supported (or already is, and we just missed it).

Our goal is to leverage mask during CI/CD to automatically run code snippets from Markdown files. These snippets usually appear as examples in documentation — for instance, demonstrating how to use a library. While we know this isn’t the original intent of the tool, mask already covers most of the functionality we need, which is amazing.

One small thing we’re missing:
We’d love to have a single command, something like mask all, that could run all mask targets defined within a Markdown file. This would allow us to verify that all embedded code examples are still working and up to date — a huge win for keeping our documentation accurate and trustworthy over time.

Does something like this already exist? If not, would this be a feature you’d consider adding, or something we could contribute?

Thanks again for the great work on mask! Looking forward to hearing your thoughts.

Best,
Frank @fr12k

[jacobdeichert]

Mask has an undocumented option that could help you here: mask --introspect

When you run that, it spits out a json representation of mask's command structure. You could make a tiny script in your language of choice that parses that json and runs all commands it finds.

[fr12k]

Nice thanks for sharing it.

Have a great day.