RST Validator

The RST Validator analyzes reStructuredText sources to detect syntax errors, improper nesting, broken references, and directive misuse. It targets developers, technical writers, and teams that rely on Python tooling, Sphinx, or CI pipelines to produce clean, durable documentation across multiple repositories and languages.
Conceptually the tool uses a docutils-based parser to build a standard AST, then applies a configurable rule set to identify issues from missing roles and opaque substitutions to invalid cross references. It reports each issue with line numbers, severity, and actionable guidance.
Unique value lies in lightweight, automation-friendly design: it can run locally or in CI, output machine-readable results, and enforce project-specific conventions through optional lint rules. It focuses on structure rather than rendering, making it ideal for pre-commit checks and early reviews.
Core features include syntax validation, reference and directive checks, configurable rule packs, UTF-8 support, and outputs suitable for automation. Typical use cases include validating RST docs before releases, during builds, or in code reviews to reduce back-and-forth.