Links & Media

Zolt uses distinct prefixes to identify different media types, allowing the parser to generate correct HTML automatically.

zolt 
[Zolt Documentation](https://zolt.marmotz.dev)

[GitHub](https://github.com/marmotz/zolt)
Result

Zolt Documentation

GitHub

zolt 
[External Link](https://example.com){target=_blank rel=noopener}

[Styled Link](page.html){color=blue fontWeight=bold}
Result

External Link

Styled Link

Avoid repeating long URLs by defining references once and using them multiple times:

zolt 
[Zolt][zolt] is the successor to Markdown.
You can find the [Zolt source code][zolt-repo] on GitHub,
and read the [Zolt documentation][zolt] to get started.
If you find a bug in [Zolt][zolt], please open an issue on [GitHub][zolt-repo].

[zolt]: https://zolt.marmotz.dev
[zolt-repo]: https://github.com/marmotz/zolt
Result

Zolt is the successor to Markdown. You can find the Zolt source code on GitHub, and read the Zolt documentation to get started. If you find a bug in Zolt , please open an issue on GitHub .

Link to specific elements with anchors:

zolt 
Jump to [Lists section](#links-media).

[Return to Reference Links](#reference-links)
Result

Jump to Lists section .

Return to Reference Links

zolt 
$site_url = "https://zolt.marmotz.dev"

Visit [our website]({$site_url}).
Result

Visit our website .

Media Prefixes

Zolt uses unique prefixes for each media type:

PrefixTypeHTML TagUsage
!Image<img>Static images (jpg, png, gif, svg)
!!Video<video>Video files (mp4, webm, ogg)
??Audio<audio>Audio files (mp3, wav, ogg)
&&File<a>Downloadable files (pdf, doc, zip)

Images

Basic Image

zolt 
![Alt text](img1.jpg)
Result

Alt text

Image with Attributes

zolt 
![Logo](logo.png){width=200px align=center}

![Photo](photo.jpg){w=300 h=200 shadow=true}
Result

Avatar

Photo

Image Attributes

AttributeDescriptionExample
w, widthWidth{w=200}
h, heightHeight{h=150}
shadowAdd shadow{shadow=true}
alignAlignment{align=center}
floatCSS float{float=right}

Videos

Local Video

zolt 
!![Kitten Video](kitten.mp4)
Result

YouTube/Vimeo

zolt 
!![Tutorial](https://www.youtube.com/embed/dQw4w9WgXcQ)
Result

Video Attributes

zolt 
!![Loop Video](kitten.mp4){autoplay loop muted}
Result

AttributeDescription
autoplayStart automatically
loopRepeat when finished
mutedStart muted

Audio

zolt 
??[Classic music](classic.mp3)
Result

Downloadable Files

Create download links with && :

zolt 
&&[Download PDF](demo.pdf)
Result

Download PDF

Media in Columns

Combine media with column layouts:

zolt 
:::columns
:::column
![Photo 1](img1.jpg){width=100%}
Caption for photo 1.
:::

:::column
![Photo 2](img2.jpg){width=100%}
Caption for photo 2.
:::
:::
Result

Photo 1 Caption for photo 1.

Photo 2 Caption for photo 2.

Complete Examples

Article with Media

zolt 
# Product Launch

![Product Image](img3.jpg){w=300 float=right}

The new product features include:

- Feature one
- Feature two
- Feature three

Watch the [demo video](#video-attributes) for more details.

&&[Download Brochure](demo.pdf)
Result

Product Launch

Product Image

The new product features include:

  • Feature one
  • Feature two
  • Feature three

Watch the demo video for more details.

Download Brochure

zolt 
:::columns
:::column
![Image 1](img1.jpg){width=100%}
:::

:::column
![Image 2](img2.jpg){width=100%}
:::

:::column
![Image 3](img3.jpg){width=100%}
:::
:::
Result

Image 1

Image 2

Image 3

Best Practices

  1. Always include alt text for accessibility
  2. Use appropriate attributes for sizing and layout
  3. Consider performance with large media files
  4. Use local references when possible for portability

© 2026 Marmotz