I was recently researching apps like this for the usecase of writing devops/tech-support "playbooks", and also (related) "runnable readmes". Among many approaches and attempts I found, I most liked the one taken by https://runme.dev, for a bunch of reasons. Did you try it? Do you (plan to) support their features and format? It was still missing a few things I'd like (including some that I see in yours), but to me it also has some advantages over yours - e.g.:
- env vars parametrization;
- a CLI tool with interactive or non-interactive interface (maybe you also have one? I didn't check);
- flags in fence-blocks rather than in frontmatter.
Runme is great. One thing I required was mobile support which I didn't see in Runme. I also thought the VS Code dependency was a bit heavy for me since I otherwise don't use VS Code.
- env vars parametrization: this is an issue I've hit myself and am looking to add a solution for it. Created an issue for it: https://github.com/ledgesh/ledge/issues/9
- CLI: Ledge does have a CLI. One gap is it can't run a code block from the CLI - another good item to add. Created as an issue: https://github.com/ledgesh/ledge/issues/10
- flags: you can add flags in the codeblock in Ledge (like confirm, norun, etc)
Thanks for the great input!