formatting

docs/skills/zensical-docs/references/index.md

@@ -4,40 +4,43 @@ Use this index to load only the source references needed for the current task.
 
 ## Zensical Official Docs
 
-- New project scaffolding (`uv run zensical new`): https://zensical.org/docs/
-- Home: https://zensical.org/docs/
-- Setup basics: https://zensical.org/docs/setup/basics/
-- Navigation setup: https://zensical.org/docs/setup/navigation/
-- Header setup and announcement bar: https://zensical.org/docs/setup/header/
-- Footer setup: https://zensical.org/docs/setup/footer/
-- Repository and content actions: https://zensical.org/docs/setup/repository/
-- Search setup: https://zensical.org/docs/setup/search/
-- 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
-- Theme extension and overrides: https://zensical.org/docs/customization/#extending-the-theme
-- Language setup: https://zensical.org/docs/setup/language/
-- Logo and icons: https://zensical.org/docs/setup/logo-and-icons/
-- Code blocks and annotations: https://zensical.org/docs/authoring/code-blocks/
-- Content tabs: https://zensical.org/docs/authoring/content-tabs/
-- Footnotes: https://zensical.org/docs/authoring/footnotes/
-- Tooltips: https://zensical.org/docs/authoring/tooltips/
+!!! info "Zensical official docs"
+    - [New project scaffolding](https://zensical.org/docs/) for `uv run zensical new`.
+    - [Home](https://zensical.org/docs/)
+    - [Setup basics](https://zensical.org/docs/setup/basics/)
+    - [Navigation setup](https://zensical.org/docs/setup/navigation/)
+    - [Header setup and announcement bar](https://zensical.org/docs/setup/header/)
+    - [Footer setup](https://zensical.org/docs/setup/footer/)
+    - [Repository and content actions](https://zensical.org/docs/setup/repository/)
+    - [Search setup](https://zensical.org/docs/setup/search/)
+    - [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)
+    - [Theme extension and overrides](https://zensical.org/docs/customization/#extending-the-theme)
+    - [Language setup](https://zensical.org/docs/setup/language/)
+    - [Logo and icons](https://zensical.org/docs/setup/logo-and-icons/)
+    - [Code blocks and annotations](https://zensical.org/docs/authoring/code-blocks/)
+    - [Content tabs](https://zensical.org/docs/authoring/content-tabs/)
+    - [Footnotes](https://zensical.org/docs/authoring/footnotes/)
+    - [Tooltips](https://zensical.org/docs/authoring/tooltips/)
 
 ## Adjacent Documentation Quality Sources
 
-- Divio documentation system: https://documentation.divio.com/
-- Write the Docs guide: https://www.writethedocs.org/guide/
-- Google developer documentation style guide: https://developers.google.com/style
-- Microsoft Writing Style Guide: https://learn.microsoft.com/style-guide/welcome/
-- MDN writing guidelines: https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines
-- Diataxis framework: https://diataxis.fr/
+!!! info "Documentation quality sources"
+    - [Divio documentation system](https://documentation.divio.com/)
+    - [Write the Docs guide](https://www.writethedocs.org/guide/)
+    - [Google developer documentation style guide](https://developers.google.com/style)
+    - [Microsoft Writing Style Guide](https://learn.microsoft.com/style-guide/welcome/)
+    - [MDN writing guidelines](https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines)
+    - [Diataxis framework](https://diataxis.fr/)
 
 ## Related Tooling References
 
-- Markdown guide: https://www.markdownguide.org/
-- Zensical setup and configuration entry point: https://zensical.org/docs/
-- Zensical customization reference: https://zensical.org/docs/customization/
-- mkdocstrings: https://mkdocstrings.github.io/
+!!! info "Related tooling"
+    - [Markdown guide](https://www.markdownguide.org/)
+    - [Zensical setup and configuration entry point](https://zensical.org/docs/)
+    - [Zensical customization reference](https://zensical.org/docs/customization/)
+    - [mkdocstrings](https://mkdocstrings.github.io/)
 
 ## Skill-Specific Deep Dives