# mdspec

> Executable Markdown Testing

Documentation drifts from code. READMEs show commands that no longer work. API examples break silently. mdspec makes your docs executable — if the example is wrong, the test fails.

## Table of Contents

### Guide

- [Getting Started](/guide/getting-started.md)
- [Pattern Matching](/guide/pattern-matching.md)
- [Persistent Context](/guide/persistent-context.md)
- [mdspec Plugin System](/guide/plugins.md)
- [Custom Commands](/guide/custom-commands.md)

### Reference

- [CLI Reference](/reference/cli.md)
- [API Reference](/reference/api.md)
- [Block Options](/reference/block-options.md)

### Other

- [mdspec Development Roadmap](/ROADMAP.md)