suggestions for RakuDoc v3

[finanalyst]

Adding this Issue to track suggestions for V3.

[finanalyst]

Include contingent blocks, eg. =begin xxx ... =else .... =end
See closed issue #52 for thread where this arose.

[finanalyst]

Add numeration options, in particular :numalias.
See #36

[finanalyst]

Add regexes to =config, see discussion in #56

[patrickbkr]

There is How to represent Declarator Docs in plain RakuDoc in problem-solving. The fundamental idea is to have a converter to convert Decks (declarator blocks) to plain RakuDoc.
Possibly it's not necessary to add any additional syntax to the RakuDoc specification.
But I do see value in specifying how Docks are to be represented in plain RakuDoc. Having a uniform representation will allow RakuDoc renderers to treat that representation specially.

Over on that problem-solving ticket two proposals have been made and lizmat has even started implementing a converter of Raku + RakuDoc -> plain RakuDoc.

[finanalyst]

Adding review of syntax styling with markup and embedding markup in code sections. See issue #60 (currently closed).