ReStructuredText Formatter

The reStructuredText Formatter ingests reST source text and outputs either HTML or a cleaned reST version. It parses a practical subset of the reST grammar, including headings, lists, code blocks, hyperlinks, and simple directives, then applies indentation normalization to ensure consistent structure. The result is deterministic and suitable for publication pipelines without altering the intended meaning.
Conceptually the tool builds an intermediate representation of the input and then renders to the selected target. In HTML mode it emits semantic elements for headings, lists, and code blocks while preserving directive semantics where possible. In rest mode it produces a portable, cleaned reST that remains faithful to the original content.
Beneficiaries include technical writers, documentation engineers, and CI workflows that require predictable outputs. Unique value lies in optional table of contents generation, basic cross-reference handling, diagnostics for unsupported directives or indentation issues, and fast, automated formatting that reduces manual edits.
Core features include a subset parser, indentation normalization, dual output targets, optional table of contents, diagnostics, and wrap width configuration. Use cases cover API docs, user guides, release notes, and any project that aims to standardize reST across teams.