About this project

This plugin enables Prettier to format AsciiDoc (.adoc) files. It uses a custom parser that preserves the original source structure while normalizing style: reflowing paragraphs to print width, standardizing attribute entries and lists, and normalizing inline formatting and whitespace. The plugin strictly preserves the rendered output's meaning, verified against Asciidoctor using a 1,614-case conformance corpus and extensive structural tests. Currently in early development, it supports paragraphs, headings, lists (including nested and checklists), delimited blocks, admonitions, inline formatting, links, macros, attributes, and conditionals. Tables are partially supported: only when the plugin fully models the table's structure (otherwise the interior is left unchanged). Description lists are not yet implemented. The plugin is not published to npm; users must build locally. It offers two configuration options for table layout (row or cell style) and column alignment, which only apply when the table is fully modeled.