Nesting shortcodes or triple colon

[OskarKlintrot]

My end goal is to get this html, roughly:

<div class="recipe">
  <div class="ingredients">...</div>
  <div class="instructions">...</div>
</div>

Triple colon gives me div's with classes, so that felt like a good place to start:

::: recipe

::: ingredients

- list
- of
- stuff

:::

::: instructions

1. how
1. to

:::

:::

That almost worked but the second div ended up as a siblings to the first instead of a child:

Let's make the first triple colon a simple shortcode instead:

public sealed class RecipeShortcode : SyncShortcode
{
    private const string Class = nameof(Class);

    public override ShortcodeResult Execute(KeyValuePair<string, string>[] args, string content, IDocument document, IExecutionContext context)
    {
        XElement div = new(
            "div",
            content,
            new XAttribute(Class, "recipe"));

        return div.ToString();
    }
}

<?! recipe ?>

::: ingredients

- list
- of
- stuff

:::

::: instructions

1. how
1. to

:::

<?!/ recipe ?>

That works like a charm!

However, now I want to use the Include shortcode and then it seems as if my Recipe shortcode escapes the inner shortcode:

How can I solve this? I tried to look through the built in shortcodes for hints but I'm still stuck at this.

---

Update: I found this answer on SO and it works great!

[OskarKlintrot]

using System.Xml.Linq;

namespace My.App;

public sealed class RecipeShortcode : SyncShortcode
{
    private const string Class = nameof(Class);

    public override ShortcodeResult Execute(KeyValuePair<string, string>[] args, string content, IDocument document, IExecutionContext context)
    {
        XElement div = new(
            "div",
            new XRaw(content),
            new XAttribute(Class, "recipe"));

        return div.ToString();
    }

    private sealed class XRaw(string text) : XText(text)
    {
        public override void WriteTo(System.Xml.XmlWriter writer) => writer.WriteRaw(Value);
    }
}

[daveaglick]

That's awesome! I haven't documented or promoted shortcodes nearly enough, so I'm thrilled you got a custom one to work for you. Hopefully 2024 is the year I get all these "hidden" features out there (and probably fix a bunch of bugs as folks start using them more heavily).