Hugo Admonitions screenshot

Hugo Admonitions

Author Avatar Theme by Kkkzoz
Updated: 12 Jan 2026
101 Stars

A lightweight Hugo module that adds beautiful and customizable admonition blocks to your content.

Overview

Hugo-admonitions is a lightweight module designed for Hugo users who want to enhance their content with visually appealing and customizable admonition blocks. Inspired by mdbook-admonish, this module provides a straightforward way to enrich content presentation, making it more informative and engaging for readers. Whether you’re crafting documentation or a blog post, integrating these stylish elements can elevate the overall user experience.

With support for both light and dark modes, as well as various customization options, Hugo-admonitions caters to diverse user needs. Whether you’re after simple style enhancements or complex nested admonition structures, this module offers the tools necessary to make your content stand out.

Features

  • Light and Dark Mode Support: Seamlessly switch between light and dark themes, ensuring readability in various lighting conditions.

  • Header Only Mode: Present vital information with a concise title, perfect for summarizing key points without clutter.

  • Foldable Admonitions: Save space and maintain an organized look by allowing users to expand and collapse content as needed.

  • Nested Admonitions: Organize complex information through nested structures that help to group related notes logically.

  • Multi-language Support: Offers localization for English, Chinese, French, German, Swahili, Czech, and Polish to cater to a global audience.

  • Customizable Color Themes: Adapt the appearance of admonitions to fit your site’s branding with customizable header text, icons, and color themes.

  • Portable Markdown Style: Compatible with popular Markdown editors such as GitHub, Obsidian, and Typora, enhancing portability across platforms.

  • Advanced SCSS Override: Provides flexibility for developers looking to modify rendering logic and further refine the visual output.