Markdown Features and Notices

This post collects common content patterns in one place so the theme can be checked against realistic Markdown, shortcodes, and MathJax on the same page.

Notice Styles

The notice shortcode supports three tones for contextual information, caution, and high-priority messages.

 1{{< notice type="info" >}}
 2Use an info notice for helpful context, such as why a page-specific asset belongs in the same leaf bundle as the post.
 3{{< /notice >}}
 4
 5{{< notice type="warning" >}}
 6Use a warning notice for checks authors should not miss, such as writing useful alt text for images that carry information.
 7{{< /notice >}}
 8
 9{{< notice type="critical" >}}
10Use a critical notice for stop-and-review items, such as confirming you have permission before publishing third-party media.
11{{< /notice >}}

Quote Block

Good content samples should combine normal prose with awkward edges: short labels, long labels, figures, notes, equations, and references.
Theme Notes

> Good content samples should combine normal prose with awkward edges: short labels, long labels, figures, notes, equations, and references.
>
> <cite>Theme Notes</cite>

Sample Picture

A Plex Live sample graphic with layered panels and a gold accent

The image above is bundled next to the post content and referenced with standard Markdown image syntax.¹

1![A Plex Live sample graphic with layered panels and a gold accent](notice-sample.svg)
2
3The image above is bundled next to the post content and referenced with standard Markdown image syntax.[^bundle-note]

MathJax

Inline equations can sit inside a sentence, such as $E = mc^2$ or $a^2 + b^2 = c^2$, without changing the surrounding typography.

1Inline equations can sit inside a sentence, such as $E = mc^2$ or $a^2 + b^2 = c^2$, without changing the surrounding typography.

A display equation is useful when the formula needs more room:

$$ \frac{d}{dx}\left(x^n\right) = n x^{n - 1} $$

1$$
2\frac{d}{dx}\left(x^n\right) = n x^{n - 1}
3$$

Aligned multiline equations work too:

$$ \begin{aligned} \nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\ \nabla \cdot \mathbf{B} &= 0 \end{aligned} $$

1$$
2\begin{aligned}
3\nabla \cdot \mathbf{E} &= \frac{\rho}{\varepsilon_0} \\\\
4\nabla \cdot \mathbf{B} &= 0
5\end{aligned}
6$$

This paragraph includes strong text, emphasis, inline code, ~~struck text~~, and an internal link so inline spacing can be checked in ordinary prose. Also regular links like the Frutiger Aero archive.

1This paragraph includes **strong text**, *emphasis*, `inline code`, ~~struck text~~, and an [internal link](/about/) so inline spacing can be checked in ordinary prose. Also regular links like [the Frutiger Aero archive](https://frutigeraeroarchive.org/).

Lists

Group related examples together.
Keep list items short enough to scan.
Include a longer list item that wraps onto a second line on narrow screens so indentation and line height can be inspected.

Start with the common path.
Add one unusual edge case.
Confirm the result in the generated page.

Render notice styles.
Render MathJax.
Review the page at multiple viewport widths.

 1- Group related examples together.
 2- Keep list items short enough to scan.
 3- Include a longer list item that wraps onto a second line on narrow screens so indentation and line height can be inspected.
 4
 51. Start with the common path.
 62. Add one unusual edge case.
 73. Confirm the result in the generated page.
 8
 9- [x] Render notice styles.
10- [x] Render MathJax.
11- [ ] Review the page at multiple viewport widths.

Table

Feature	Syntax	Theme concern
Notices	Shortcode	Tone and spacing
Image	Markdown	Alt text and sizing
MathJax	$...$ and `$$...$$`	Script opt-in
Footnote	`[^name]`	Backlinks and rhythm

1| Feature | Syntax | Theme concern |
2| --- | --- | --- |
3| Notices | Shortcode | Tone and spacing |
4| Image | Markdown | Alt text and sizing |
5| MathJax | `$...$` and `$$...$$` | Script opt-in |
6| Footnote | `[^name]` | Backlinks and rhythm |

Spoiler

Collapsed Markdown with MathJax and an image

This content starts collapsed, but it still renders ordinary Markdown when opened.

A Plex Live sample graphic with layered panels and a gold accent

Spoilers can contain lists.
They can contain links such as About.
They can contain inline equations like $a^2 + b^2 = c^2$.

$$ \sum_{n=1}^{4} n = 10 $$

 1{{< spoiler title="Collapsed Markdown with MathJax and an image" >}}
 2This content starts collapsed, but it still renders ordinary Markdown when opened.
 3
 4![A Plex Live sample graphic with layered panels and a gold accent](notice-sample.svg)
 5
 6- Spoilers can contain lists.
 7- They can contain links such as [About](/about/).
 8- They can contain inline equations like $a^2 + b^2 = c^2$.
 9
10$$
11\sum_{n=1}^{4} n = 10
12$$
13{{< /spoiler >}}

Code Block

1[params]
2description = "A short site description"
3cardSummaryLength = 180

1```toml
2[params]
3description = "A short site description"
4cardSummaryLength = 180
5```

The examples are intentionally compact, but they cover the elements most likely to show spacing, contrast, or wrapping issues in a post body.

YouTube videos

1{{< youtube jNQXAC9IVRw >}}

Footnotes

Footnotes are defined at the bottom of the page as follows:

1[^bundle-note]: Leaf bundles keep page-specific assets close to the content that uses them, which makes sample posts easier to move or delete.

Leaf bundles keep page-specific assets close to the content that uses them, which makes sample posts easier to move or delete. ↩︎