---
title: "Hugo Pack"
description: "Using ASW with Hugo — the theme, shortcodes, and configuration."
type: docs
weight: 52
date: 2026-04-11
tags: ["packs", "hugo"]
ai-disclosure: "generated"
ai-model: "claude-sonnet-4-6"
ai-provider: "Anthropic"
---

The Hugo pack (`packs/hugo/`) is a complete Hugo theme built on ASW. It maps Hugo's Markdown pipeline to semantic HTML that ASW styles automatically. This documentation site is built with it.

## Setup

Symlink or copy `packs/hugo/` into your Hugo project's `themes/` directory, then set `theme = "asw-hugo"` in `hugo.toml`. Enable unsafe HTML rendering so that raw HTML blocks in Markdown pass through:

```toml
[markup.goldmark.renderer]
  unsafe = true

[markup.tableOfContents]
  startLevel = 2
  endLevel   = 3
  ordered    = false
```

The pack provides layouts for `docs`, `blog`, and default page types. No additional configuration is required for basic use.