Formatter voor reStructuredText

De ReStructuredText Formatter neemt reST-tekst als invoer en levert HTML of een schone reST-uitvoer. Het parseert een pragmatische subset van de reST-grammatica, inclusief kopjes, lijsten, code-blokken, hyperlinks en eenvoudige directives, en past inspringingsnormalisatie toe om een consistente structuur te garanderen. Het resultaat is deterministisch en geschikt voor publicatie-pijplijnen zonder de bedoeling inhoudelijk te veranderen.
Conceptueel bouwt de tool een tussenrepresentatie van de invoer en renderen naar het geselecteerde doel. In HTML-modus genereert het semantische elementen voor kopjes, lijsten en code-blokken terwijl de directive-semantiek waar mogelijk behouden blijft. In rest-modus produceert het draagbare reST dat trouw blijft aan de oorspronkelijke inhoud.
Belanghebbenden zijn technische schrijvers, documentatie-ingenieurs en CI-workflows die voorspelbare resultaten eisen. Unieke waarde ligt in optionele inhoudsopgavegeneratie, basis cross-referencing, diagnostiek bij niet-ondersteunde directives of indentatieproblemen, en snelle, geautomatiseerde opmaak die handmatige bewerkingen vermindert.