Inconsistent behavior when including code snippets in an alert

[sharifsalah]

Currently, when we include a code snippet in an alert we see inconsistent behavior:

1. Using back ticks:

{{% alert %}} Here's an example command:

    ```shell
    my example command
    ```

    {{% /alert %}}

Results in the back ticks displaying in the rendered HTML.

2. Using indentation alone:

{{% alert %}} Here's an example command:

    my example command

    {{% /alert %}}

Results in the code snippet rendering correctly (even though the command isn't really indented).

For screenshots, see AcademySoftwareFoundation/opencue.io#147

[LisaFC]

I'll have a look! Which version of Hugo are you using? The 0.60 versions and up use a different Markdown processor (Goldmark) which is mildly less weird than Blackfriday.

[sharifsalah]

Thanks @LisaFC! We're running a version of Hugo prior to 0.6.0, so I'll experiment with updating and report back if that fixes the behavior.

[LisaFC]

Be aware that it may break other things! :)

https://www.docsy.dev/docs/adding-content/content/#page-contents-and-markup

There's also a rogue div that may appear on your landing page depending on how much customization you did, which you can just delete: #174

[sharifsalah]

Thanks again, that all helped!

To update you on the original issue, I've tried updating Hugo, Docsy, and enabling HTML in Markdown. The site is generally looking as expected. I can still see the strange behavior in the description for this issue:

https://deploy-preview-150--elated-haibt-1b47ff.netlify.com/docs/getting-started/setting-up-the-database/

If you want to see it, you can search for the following string on that page:

```shell

Not a big issue but worth reporting :)

[LisaFC]

Ok! Let's see if I can figure it out....

[RichieEscarez]

This sounds like it might be the cause: gohugoio/hugo#5831 (comment)

[LisaFC]

Closing as looks like this was fixed in Hugo.