{"repo":"runkids/mdproof","free":true,"listed":false,"github":"https://github.com/runkids/mdproof","clone":"git clone https://github.com/runkids/mdproof.git","description":"🧪 Turn Markdown docs and runbooks into executable tests","language":"Go","stars":14,"topics":["ai-agents","cli","devtools","e2e-testing","go","markdown","testing","documentation-testing","integration-testing","runbooks"],"license":"MIT","category":"dev-tools","readme_excerpt":"Turn Markdown into executable tests. mdproof runs the commands in your docs, runbooks, and smoke tests, then verifies the result with assertions. Use one .md file for documentation, operational steps, and CI checks. Best for README example verification , CLI and API smoke tests , deploy runbooks , and agent-generated workflows . ⚠️ Under active development — APIs and runbook format may change. --- What mdproof does mdproof executes shell steps from a Markdown file and checks the output with assertions like exit code , jq , substring matching, regex, and snapshots. That makes Markdown useful for more than prose: - Your README examples can become runnable checks. - Your deploy runbooks can become executable verification steps. - Your smoke tests can stay readable by humans and writable by agents. Instead of splitting documentation and tests across different formats, mdproof keeps them in one place. bash curl -s -X POST http://localhost:8080/users -d '{\"name\":\"alice\"}' The test is the documentation. When it fails, the error points to the exact step and expectation that broke. Why teams use it - Docs stop drifting : examples in README.md or docs/ .md can be verified in CI. - Runbooks become safer : the same file an operator reads can be executed during deploy verification. - Agents fit naturally : agents already write Markdown well, so they can generate or repair tests without learning a test framework API. - Review stays simple : a Markdown diff is easier to inspect than a custo","default_branch":null,"files":null,"tree":[],"storefront":"/r/runkids","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/runkids/mdproof/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}