Shortcodes on Yore

Writing

Sat, 17 Jan 2026 10:40:00 +0800

Admonition

Admonitions allow you to insert eye-catching callout boxes in your content.

Example: Markdown syntax with custom icon

> [!TIP]+ Custom Title
> This is a collapsible tip with a custom icon.
{icon="twitter"}

Custom Title

This is a collapsible tip with a custom icon.

Media and Content Embeddings

Sat, 17 Jan 2026 10:40:00 +0800

Article Card

The article shortcode generates a visual preview card for a specified internal page.

Parameter	Description
`link`	Required. The logical path of the target internal page.
`showSummary`	Optional. Whether the page summary is displayed. Default: `true`
`lang`	Optional. Get page from another language of your site.

Example

Math

Sat, 17 Jan 2026 10:40:00 +0800

Render LaTeX math in pages using .

Configuration

Configure Goldmark to bypass math delimiters:

hugo.yaml
markup:
 goldmark:
 extensions:
 passthrough:
 enable: true
 delimiters:
 block:
 - ['\[', '\]']
 - ['$$', '$$']
 inline:
 - ['\(', '\)']

Passthrough skips Goldmark processing for matched content. Then enable math per page:

Chart

Sat, 17 Jan 2026 10:40:00 +0800

Chart

chart uses the to embed charts into articles. It supports a vast range of .

Note

The chart shortcode places your code directly into a <script> tag. To ensure compatibility:

Mermaid

Sat, 17 Jan 2026 10:40:00 +0800

Mermaid

mermaid allows you to draw detailed diagrams and visualisations using text. It uses Mermaid under the hood and supports a wide variety of diagrams, charts and other output formats.