cat Shortcode Reference.md
# Every << >> tag available in this site, generated straight from the plugin registry.
Every <<tag:...>> available in this site's content โ generated automatically from the registered plugins. Drop a new file in src/shortcodes/plugins/ (or call registerShortcode()) and it appears here on the next build. See PLUGINS.md for how to add your own.
<<audio:...>>
Embeds a self-hosted audio file with native controls.
<<audio:track.mp3>>
<<banner:...>>
Places a picture as a full-width hero banner: `image|headline|subtext` (headline/subtext optional).
<<banner:/hero.jpg|Welcome to Acme|Handcrafted goods, made to last.>>
<<button:...>>
A call-to-action button: `label|url`.
<<button:Buy Now|https://example.com/checkout>>
<<card:...>>
grids when repeated
A content card: `image|title|description`. Consecutive cards auto-arrange into a grid.
<<card:/photo.jpg|Title|A short description>>

<<color:...>>
A color swatch chip: `#hex|label`.
<<color:#6C63FF|Brand Purple>>
<<countdown:...>>
A live countdown to a date: `ISO-date|label`. Ticks client-side.
<<countdown:2026-12-31T00:00:00|New Year>>
<<feedback:...>>
A quick feedback widget: `question|option1|option2|...` (defaults to Yes/No).
<<feedback:Was this page helpful?|Yes|No>>
<<flipcard:...>>
grids when repeated
A card that flips on hover to reveal text: `image|title|back text`. Consecutive cards auto-arrange into a grid.
<<flipcard:/photo.jpg|Title|Revealed on hover>>
<<glossary:...>>
An inline term with a hover/tap tooltip definition: `term|definition`.
<<glossary:SSG|Static Site Generator>>
<<image:...>>
Embeds a lazy-loaded image.
<<image:/photo.jpg>>

<<link:...>>
A styled outbound link card: `url|label`.
<<link:https://example.com|Visit Example>>
<<logo:...>>
grids when repeated
Places a picture as a styled logo mark: `image|alt|link` (alt/link optional).
<<logo:/brand/logo.svg|Acme Co|/home/>>
<<notice:...>>
An informational callout box.
<<notice:Heads up โ this page is a work in progress.>>
<<pdf:...>>
Embeds a PDF viewer with a download link. Put the file next to content.md, or in a media/ folder (`/media/x.pdf`).
<<pdf:brochure.pdf>>
<<productcard:...>>
grids when repeated
A shop-style product card: `image|title|price|description`. Consecutive cards auto-arrange into a grid.
<<productcard:/mug.jpg|Ceramic Mug|$18|Dishwasher safe, holds 12oz.>>

<<profilecard:...>>
grids when repeated
A person/team profile card: `image|name|role|bio`. Consecutive cards auto-arrange into a grid.
<<profilecard:/avatar.jpg|Jane Doe|Founder|Loves building things.>>
<<progress:...>>
A percentage progress bar.
<<progress:72%>>
<<quote:...>>
A pull-quote: `text|author`.
<<quote:Stay hungry, stay foolish.|Steve Jobs>>
Stay hungry, stay foolish.โ Steve Jobs
<<rating:...>>
A star rating: `value|max` (max defaults to 5).
<<rating:4.5|5>>
<<slider:...>>
A multi-line image carousel: one `src|caption` per line.
<<slider:
/a.jpg|First
/b.jpg|Second
>>
<<soundcloud:...>>
Embeds a SoundCloud player.
<<soundcloud:https://soundcloud.com/artist/track>>
<<tiktok:...>>
Embeds a TikTok video.
<<tiktok:https://www.tiktok.com/@user/video/1234567890>>
<<typing:...>>
A client-side animated typing effect cycling through phrases.
<<typing:Designer|Developer|Dreamer>>
<<video:...>>
Embeds a self-hosted video file with native controls.
<<video:clip.mp4>>
<<youtube:...>>
Embeds a responsive YouTube video player.
<<youtube:https://youtu.be/dQw4w9WgXcQ>>
Nisan- The Mark