Each guide solves one task. Find the goal, follow the link.
| If you want to... | Read |
|---|---|
| Add an icon set (Tabler, Heroicons, Material Design, etc.) to a project | Working with Icon Sets |
| Resize, rotate, flip, or style an icon | Icon Manipulation |
| Control how attributes merge across five layers | Attribute Management |
| Map shorthand names or handle missing icons gracefully | Aliases & Fallbacks |
| Render icons inline in Markdown content | Goldmark Integration |
See the :icon[...] syntax rendered live |
Markdown Icon Showcase |
Deduplicate repeated inline SVGs with <use> references |
Sprite Sheets |
| Pick the right provider for throughput or optimize cache behavior | Performance & Caching |
| Use icons in a Hugo site or theme | Hugo Integration |
Working with Icon Sets
Bring in third-party icon families such as Tabler or Heroicons via CLI download, embedding, or the Iconify API.
Icon Manipulation
Chain fluent Icon methods to resize, rotate, flip, and restyle icons without mutating the original.
Attribute Management
See how the five-layer attribute merge decides which values win on a rendered icon.
Web Integration
Render icons in a net/http application with html/template, including why the template.HTML cast is safe.
Aliases & Fallbacks
Map shorthand icon names to real targets and configure fallback icons for failed lookups.
Goldmark Integration
Embed icons directly in Markdown content using the Goldmark extension's inline icon syntax.
Markdown Icon Showcase
Live demonstration of the :icon[...] inline syntax: every icon on this page is rendered by go-swarm-icons.
Sprite Sheets
Cut duplicate markup on a page by sharing repeated icons through symbol-based sprite sheets.
Performance & Caching
Compare provider caching behavior and choose a strategy suited for high-throughput rendering.
Hugo Integration
Use CLI-exported icons in Hugo partials and shortcodes, or pre-generate sprite sheets for icon-heavy themes.