Code, snippets, and directives
Examples should be small enough to understand and complete enough to try.
Highlighted code
A title identifies the file, line numbers support discussion, and a highlight directs attention.
Inline highlighting works too: greet("reader").
Show Markdown source
Annotations
Select the numbered marker for an explanation alongside the code.
- The target names the output directory for this illustrative configuration.
Show Markdown source
Reusable fixed text
The following source file is included at build time using the Snippets extension.
Show Markdown source
References
Conditional directives
The official directives extension is distributed separately through Zensical Spark. It uses a catalog and a selected variant; it is not enabled in this example site. The following is illustrative source, not a live demo.
@if deployment = cloud
Open the cloud console.
@else
Configure the local service.
This guide covers @var{deployment}.
@use shared/security-notice.md
See the directives guide for installation, catalog configuration, conditions, variables, and source reuse.