[Feature Request]: Parse substitutions as Markdown

[swallez]

Prerequisites

• I have searched existing issues to ensure this feature hasn't already been requested
• I have tested using the latest version of docs-builder

What problem are you trying to solve?

The previous doc system considered substitution values as AsciiDoc markup. The new system considers them as plain text.

The Java client was using this to insert a paragraph at the end of pages containing code samples linking to the complete source of theses samples in the GitHub repository (see substitution definition and its usage). Using a substitution for this reduces typing and ensures consistency.

Using snippets is a workaround that works in this specific case, but snippets are blocks and thus cannot be used for inline snippets such as a name and a link.

Proposed Solution

Expand substitutions before rendering markup.

Examples and Research

No response

Alternative Solutions

No response

Additional Context

No response

How important is this feature to you?

Nice to have

[shainaraskas]

I believe this is the same issue or related: #152

[swallez]

Indeed you're right, I didn't use proper search terms to find it. Closing, then.