Add support for outputting to Asciidoc format

Christopher-Chianelli commented 10 months ago

Asciidoc is very similar to Markdown, but it has a few differences:

It uses = for headers instead of #
It uses multiple * for nested lists instead of indents
It uses \n'''\n for horizontal rule instead of ---\n
Blocks quotes in Asciidoc are done like this: ---- QUOTED TEXT ACROSS MULTIPLE LINES ---- versus how it done in Markdown > QUOTED TEXT > ACROSS MULTIPLE LINE

Due to these similarities, they basically share the exact same render code! The core implementation of MarkdownRender was moved to an abstract base class MarkdownRenderBase (with abstract methods for getting the symbols for LI, HR, etc.), with MarkdownRender now just defining those abstract methods. AsciidocRender also extends the same base class, and also overrides the blockquote method since blockquoting is done quite differently and is not a simple symbol replacement.

westse commented 10 months ago

How about a CLI option and readme update?

joschi commented 6 months ago

Superseded by #569.

OpenAPITools / openapi-diff

Add support for outputting to Asciidoc format #559