Theme Showcase: Shortcodes in Practice
Shortcodes give authors a small set of structured elements without requiring custom HTML in every article.
The theme also includes a details shortcode for optional information.
What belongs in a details block?
Use details for supporting material that is useful but not essential on the first read. Examples include setup notes, references, definitions, or longer explanations.
External links can be written with explicit text and safe attributes. For example, see the Hugo website.
Plain Markdown Still Works
Shortcodes should complement ordinary markdown rather than replace it. Most posts should still be mostly headings, paragraphs, lists, and links.