Skip to content

Images

This local SVG provides an accessible, self-contained illustration.

Three connected stages: draft, review, publish
A small documentation workflow, from draft to publication.
Show Markdown source
<figure markdown="span">
  ![Three connected stages: draft, review, publish](../assets/authoring/workflow.svg){ width="600" }
  <figcaption>A small documentation workflow, from draft to publication.</figcaption>
</figure>

Lazy loading and palette variants

The same local illustration is used for both palettes here. Swap in different files when your artwork needs distinct contrast.

Workflow for light mode Workflow for dark mode

Show Markdown source
![Workflow for light mode](../assets/authoring/workflow.svg#only-light){ loading=lazy width="400" }
![Workflow for dark mode](../assets/authoring/workflow.svg#only-dark){ loading=lazy width="400" }

Alignment

A small image can sit beside text. On narrow screens it may use the available width instead.

A three-stage workflow

A draft passes through review before publication. The illustration reinforces the sequence while leaving the prose readable.

Show Markdown source
![A three-stage workflow](../assets/authoring/workflow.svg){ align=right width="240" }

A draft passes through review before publication. The illustration reinforces the sequence while leaving the prose readable.

References

Caption extension

A caption can follow an image without HTML. This uses pymdownx.blocks.caption.

A three-stage workflow

Draft, review, and publish.

Show Markdown source
![A three-stage workflow](../assets/authoring/workflow.svg){ width="400" }
/// caption
Draft, review, and publish.
///