# The 21 Named Macrostructures in Hallmark: Complete Design System Layout Guide

> Discover the 21 named macrostructures in Hallmark's design system. This guide details each layout pattern, including the Long Document structure, for efficient page design.

- Repository: [Hassan El Mghari/hallmark](https://github.com/Nutlope/hallmark)
- Tags: getting-started
- Published: 2026-08-02

---

**Hallmark provides 21 standardized macrostructures—numbered 01 through 21—that define distinct page layout patterns, with the "Long Document" (02) structure specifically designed for continuous prose content.**

The `Nutlope/hallmark` repository implements a rigorous design system built around **21 named macrostructures** that standardize page layouts. These macrostructures, cataloged in the project's reference documentation, provide specific templates for organizing content ranging from marketing pages to long-form documents.

## Understanding Hallmark's 21 Macrostructure Catalog

The complete inventory of layout templates resides in [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md). This index enumerates all **21 named macrostructures** that form the foundation of Hallmark's layout architecture. Each macrostructure represents a distinct page pattern, numbered sequentially from 01 through 21.

## The Numbering Convention: Arabic and Roman Numerals

While most macrostructures in the Hallmark system use Arabic numerals (01, 03-21), the second entry uniquely carries the Roman numeral **II** label, corresponding to **"02"** in the file naming convention.

This distinction appears in the repository structure where the Long Document macrostructure is identified as "02" despite its Roman numeral designation. The remaining macrostructures follow standard Arabic numbering (01, 03 through 21) or use descriptive identifiers.

## Deep Dive: The Long Document (02) Macrostructure

According to [`skills/hallmark/references/macrostructures/02-long-document.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures/02-long-document.md), the macrostructure labeled **II (Long Document)** serves pages that read like memos, letters, or journal entries.

### Layout Characteristics

The Long Document macrostructure enforces a specific content architecture:

- **Continuous prose** flow without interruption
- **Inline section headings** that break up text naturally
- **Absence of marketing-style hero layouts** that typically appear on landing pages

This structure prioritizes readability for lengthy text content over promotional presentation.

### Implementation Example

When implementing the Long Document pattern, apply the semantic HTML structure and corresponding CSS identifiers:

```css
/* Hallmark · macrostructure: Long Document */

```

```html
<section class="long-document">
  <h2>Chapter 1 – Introduction</h2>
  <p>…continuous prose…</p>
</section>

```

## Locating the Complete Reference Documentation

For the exhaustive list of all 21 macrostructures, consult the primary index at [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md). Individual specifications for each layout pattern reside in dedicated files following the [`skills/hallmark/references/macrostructures/XX-descriptive-name.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures/XX-descriptive-name.md) naming convention, where `XX` represents the two-digit numerical identifier.

## Summary

- Hallmark defines **21 named macrostructures** that provide standardized layout templates.
- The macrostructures are numbered 01 through 21, with "02 Long Document" uniquely bearing the Roman numeral II designation.
- The Long Document (02) pattern supports continuous prose content like memos and journals, featuring inline headings and no hero sections.
- Complete documentation resides in [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md) with individual definitions stored in the `macrostructures/` subdirectory.

## Frequently Asked Questions

### What defines a macrostructure in the Hallmark design system?

A macrostructure in Hallmark is a standardized page layout template that dictates content organization, visual hierarchy, and component arrangement. The system catalogs 21 distinct patterns, each optimized for specific content types ranging from marketing landing pages to dense textual documents.

### Why does the Long Document use Roman numeral II instead of Arabic numerals?

While the file system identifies this pattern as [`02-long-document.md`](https://github.com/Nutlope/hallmark/blob/main/02-long-document.md), the design documentation references it with the Roman numeral **II**. This appears to be a semantic distinction within Hallmark's taxonomy, though the practical implementation uses the Arabic "02" prefix consistent with the broader numbering scheme (01, 03-21).

### Where can I find the complete list of all 21 Hallmark macrostructures?

The authoritative index listing all **21 named macrostructures** is located at [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md). This file provides the master catalog, while individual specifications for each layout are detailed in separate files within the `skills/hallmark/references/macrostructures/` directory.

### How is the Long Document macrostructure different from other layout patterns?

Unlike marketing-focused macrostructures that utilize hero layouts and promotional formatting, the Long Document (02) pattern specifically accommodates continuous prose flow. It structures content like traditional memos or journal entries with inline headings rather than discrete sectional breaks, optimizing for extended reading sessions.