mdv fix

Apply every safe autofix in place.

Resistance is futile. Every safe autofix will be assimilated into your document.

Usage

mdv fix [files...] [options]

Arguments

  • [files...] — Markdown documents or directories to fix; default: every auto-discovered *.mdv.md → *.md pair.

Output

  • -f, --format FORMAT — stylish (default) or json.
  • --dry-run — Show a unified diff of what would change without writing any file.

Safety

  • --allow-deletions — Also apply fixes that delete authored content (e.g. an undeclared section); withheld and reported by default.

Contract selection

  • --schema FILE — Use an explicit contract instead of discovering one.
  • --title TEXT — Supply the PR, issue, or document title validated by title rules.

Context

  • --context FILE — Load JSON title, issue, and value context.
  • --now DATE — Inject the ISO date or datetime read by freshness rules; an explicit context values.now wins.

Examples

mdv fix                               # fix every auto-discovered *.mdv.md/*.md pair in place
mdv fix README.md                     # fix one file against its README.mdv.md sibling
mdv fix --dry-run README.md           # show a diff of what fix would change, without writing
mdv fix --allow-deletions README.md   # also apply fixes that delete content (withheld by default)

Model-assisted repair: validate LLM output.

mdv check

Validate Markdown documents against their contracts: in a terminal, in CI, or on stdin.

mdv init

Write the optional config or the agent skill (starters are being rebuilt).

On this page

UsageArgumentsOutputSafetyContract selectionContextExamples