Allow subs in stepper headings

[theletterf]

Fixes #1658

[github-actions]

🔍 Preview links for changed docs

• docs/contribute/locally.md

[theletterf]

@eedugon You can test it out here: https://docs-v3-preview.elastic.dev/elastic/docs-builder/pull/1659/contribute/locally#run-docs-builder

The source for that step title is https://github.com/elastic/docs-builder/pull/1659/files#diff-04d89933862130b932e71ef5f244ca08fb9084c587a25ca2be796133f7fb3f84R148

[theletterf]

@elastic/docs-engineering Please have a look — thanks!

[reakaleek]

I'm wondering if we could use the actual HTML renderer for rendering the heading.

This would then cover all the things.

[theletterf]

@reakaleek PTAL!

[reakaleek]

@reakaleek PTAL!

Ah, sorry for being ambiguous. I meant like.. the markdig renderer. So that all markdown syntax is covered.

[Mpdreamz]

We already override parsing headers here:

https://github.com/elastic/docs-builder/blob/e19ef301a0a718042a074b5e314db9d4f8c2f8fc/src/Elastic.Markdown/Myst/InlineParsers/HeadingBlockWithSlugParser.cs#L25-L24

But no custom renderer yet.. Not sure we need it as the headers are already parsed and pick up subs.

[Mpdreamz]

But not sure I understand completely @reakaleek the stepper circumvents markdown headers by using its own renderer? You want the renderer to call the default markdown header renderer which already parses and replaces subs? instead of using <hN> for the directive?

[reakaleek]

But not sure I understand completely @reakaleek the stepper circumvents markdown headers by using its own renderer? You want the renderer to call the default markdown header renderer which already parses and replaces subs? instead of using <hN> for the directive?

I think we could either recursively, or use the existing static markdown pipeline to render the LeafInline or something like that.

That way the heading would support all the things our markdown supports.

[reakaleek]

@reakaleek Is 055f622 the answer? 🙏🏻

I'm not sure.. if what I'm trying to convey would work.. you could remove the custom ReplaceSubstitutions logic and the markdig renderer would handle it.

[theletterf]

@Mpdreamz @reakaleek I think it's ready now!