Continuing the discussion from Rendering code blocks properly from .md files:
@mojoa It’s just my personal preference to not use shortcodes.
The source of content for my sites is in Org mode (https://orgmode.org). What Hugo does using shortcodes can already be done (mostly) using Org macros.
I call Org mode an “active” markup language… because it can be powered using Emacs-Lisp.
Markdown on the other hand is “passive”. To give smarts to Markdown, things like Hugo shortcodes are needed.
Once you start baking shortcodes in your Markdown content, that content stops becoming portable and cannot be rendered directly by other Markdown parsers.
For that reason, I avoid using the shortcodes.