formatting

docs/skills/zensical-docs/references/theme-customization-and-icons.md

@@ -15,11 +15,12 @@ Always start new projects with `uv run zensical new` so the baseline theme/confi
 
 ## Key Zensical Customization Surfaces
 
-- Customization overview: https://zensical.org/docs/customization/
-- Additional CSS: https://zensical.org/docs/customization/#additional-css
-- Additional JavaScript: https://zensical.org/docs/customization/#additional-javascript
-- Extending the theme: https://zensical.org/docs/customization/#extending-the-theme
-- Logo and icons setup: https://zensical.org/docs/setup/logo-and-icons/
+!!! info "Zensical sources"
+    - [Customization overview](https://zensical.org/docs/customization/)
+    - [Additional CSS](https://zensical.org/docs/customization/#additional-css)
+    - [Additional JavaScript](https://zensical.org/docs/customization/#additional-javascript)
+    - [Extending the theme](https://zensical.org/docs/customization/#extending-the-theme)
+    - [Logo and icons setup](https://zensical.org/docs/setup/logo-and-icons/)
 
 ## Colors and Accessibility
 
@@ -27,21 +28,22 @@ Always start new projects with `uv run zensical new` so the baseline theme/confi
 - Keep contrast high for body text, code blocks, and nav labels.
 - Test color changes on mobile and desktop, including search highlights and active nav states.
 
-General references:
-- Material design color guidance: https://m3.material.io/styles/color
-- WCAG overview: https://www.w3.org/WAI/standards-guidelines/wcag/
+!!! info "General references"
+    - [Material Design color guidance](https://m3.material.io/styles/color)
+    - [WCAG overview](https://www.w3.org/WAI/standards-guidelines/wcag/)
 
 ## Icons: Selection and Search Landing Pages
 
 If your theme supports icon sets through your docs stack, these search portals are useful:
 
-- Material Symbols search: https://fonts.google.com/icons
-- Font Awesome icons search: https://fontawesome.com/search
-- Simple Icons search: https://simpleicons.org/
-- Iconify icon set search: https://icon-sets.iconify.design/
-- Lucide icons: https://lucide.dev/icons/
+- [Material Symbols search](https://fonts.google.com/icons)
+- [Font Awesome icons search](https://fontawesome.com/search)
+- [Simple Icons search](https://simpleicons.org/)
+- [Iconify icon set search](https://icon-sets.iconify.design/)
+- [Lucide icons](https://lucide.dev/icons/)
 
-Tip: pick one primary icon family for navigation and status icons, then document naming conventions.
+!!! tip "Icon family consistency"
+    Pick one primary icon family for navigation and status icons, then document naming conventions.
 
 ## Extending the Theme Safely