snipr — Execute Markdown code blocks with precision

Turn your Markdown documents into runnable scripts.

Run shell commands and Go code directly from Markdown, respecting dependencies, exporting outputs, and saving to files.

• execute runnable code blocks in Markdown
• topological sorting of blocks based on depends
• export block output to environment variables (export) or files (file)
• skip blocks selectively with skip=true
• specify working directory (dir) and timeout (timeout)
• lightweight CLI-first tool, fully standalone

• CLI-first and lightweight — no editor or notebook required
• handles dependencies, exports, and file outputs out of the box
• focused on Markdown workflows, not just single snippets
• extensible to new languages and execution strategies
• ideal for automation, literate programming, and reproducible docs

All tools are completely free to use, with every feature fully unlocked and accessible.

If you find one or more of these tool helpful, please consider supporting its development with a donation.

Your contribution, no matter the amount, helps cover the time and effort dedicated to creating and maintaining these tools, ensuring they remain free and receive continuous improvements.

Every bit of support makes a meaningful difference and allows me to focus on building more tools that solve real-world challenges.

Thank you for your generosity and for being part of this journey!

• macOS
• Windows
• Linux (arm64)
• Linux (amd64)

» macOS » Homebrew

brew tap lucasepe/cli-tools
brew install snipr

Run a demo Markdown file directly from GitHub:

curl -sL https://raw.githubusercontent.com/lucasepe/snipr/main/testdata/basic.md | snipr run

This demonstrates dependencies, exports, file output, and skipped blocks in action.