Open source
Irondocs
Runs the code blocks in Markdown docs as real pytest, vitest or jest tests, so examples cannot drift out of sync with the code.
captureirondocs.dev
Irondocsdocs that run as tests
What it is
A test harness for documentation. Mark a code block in a Markdown file as a test and it runs as a real assertion — under pytest in Python, or vitest or jest in TypeScript — named after the nearest heading, with no separate test file.
Why it exists
Documentation examples rot silently. An API changes, the tests are updated, and the README keeps demonstrating the old signature until somebody copies it and files a bug. Running the examples is the only way to know they still work.
Our part in it
We maintain it, and it runs against our own documentation — which is how the examples on the other project pages stay honest.
What we build it on
Fast unit tests, recorded HTTP, and documentation that fails the build when it goes stale.
One toolchain across every repository, so moving between them costs nothing.
Get in touch
Tell us what you need built.
We are a small team in Portugal, working London hours. A site, an app, an internal tool, or the platform behind them — start with a sentence about the problem and we will take it from there.