| name | image |
| description | Embed an image with optional caption, title, dimensions, alignment, and HTML attributes. Use for screenshots, diagrams, hero images, inline figures. |
Image
Standard Markdown image syntax extended with sizing, alignment, captions, and
arbitrary HTML attributes.
Basic
Sizing
Pipe-separated widthxheight or just width:
Or with the attribute block:
{ width="300" height="200" }
Attribute block
Add { … } for id, classes, and any HTML attribute:
{ #hero .rounded-lg width="600" }
{ .border .shadow loading="lazy" }
Alignment
Wrap the markdown image with - (single) or -- (with extra padding):
-
-
--
--
Tips
- Prefer root-relative paths (
/assets/foo.png). They survive permalink
overrides and multi-repo nesting.
- Always provide alt text — leave it empty (
) only when the image is
purely decorative.
- For PDF previews, the same
![]() syntax works because Neko detects the
.pdf extension. See pdf.
- Add
loading="lazy" via the attribute block for non-critical images.
