FAQ

What mediva checks, what it doesn't, and how to run it — the short answers.

Deep Thought: "The answer is 42." The question, as usual, was never specified. Specify yours.

What is mediva?

Checks Markdown against a contract.

What does it check?

<!-- mdv: section required content.words.min=20 content.none=@placeholders -->
## Summary

<!-- mdv: section required -->
## Checklist

<!-- mdv: list required items.all=checked labels.eq=@template -->
- [ ] Tests added or updated

Sums: @tables/total, @numbers/sums.

What doesn't it check?

Style, grammar, spelling, truth.

Does it use an AI model?

No. Same input, same result.

How do I run it?

npm install -D mediva
npx mediva check report.md --schema report.mdv.md

TypeScript: compile(contract).check(markdown) (result.gate is null when it passes); no Python SDK yet. Quickstart.

Does it actually help?

See our benchmark and the outside research.

Mediva CI

Gate pull requests and issues on GitHub with a copy-in workflow — friendly, signal-not-verdict checks that never reject the author.

Contracts

A contract is plain Markdown with mdv rules — kept beside the document, template, or workflow it checks.

On this page

What is mediva?What does it check?What doesn't it check?Does it use an AI model?How do I run it?Does it actually help?