# What Are the 21 Named Macrostructures in Hallmark?

> Discover the 21 named macrostructures in Hallmark. Learn about these standardized document templates and their unique numbering system for efficient documentation.

- Repository: [Hassan El Mghari/hallmark](https://github.com/Nutlope/hallmark)
- Tags: deep-dive
- Published: 2026-08-09

---

**Hallmark defines 21 standardized document templates called macrostructures, cataloged in [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md), which mix Arabic numerals (01, 03‑21) with the Roman numeral II (02) for the Long Document layout.**

Hallmark is a design system that organizes content through rigid structural templates. The system recognizes 21 distinct macrostructures—reusable page architectures that dictate how information flows from headings to body text. These patterns are enumerated in the central macrostructures index and individually documented in dedicated reference files.

## Where Hallmark Defines Its 21 Macrostructures

The canonical list of all 21 named macrostructures resides in [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md). This index assigns each macrostructure a unique identifier, with the majority using Arabic numerals (01, 03 through 21) while one exception uses a Roman numeral label.

## The Roman Numeral II: Long Document (02)

The macrostructure designated **II**—also referenced as **02**—is the **Long Document**. According to the Hallmark source code, this template describes pages that read like memos, letters, or journal entries, characterized by continuous prose with inline section headings and the absence of marketing-style hero layouts.

### Implementation Details

In [`skills/hallmark/references/macrostructures/02-long-document.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures/02-long-document.md), the Long Document is specified as using standard heading hierarchies within flowing text rather than modular card layouts. The structure prioritizes readability for extended text content.

### Code Implementation

When implementing the Long Document macrostructure in CSS and HTML:

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

```

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

```

## The Complete Macrostructure Numbering System

The 21 macrostructures follow a sequential numbering pattern with one distinct exception:

- **01**: First macrostructure (detailed in index)
- **II (02)**: Long Document (unique Roman numeral designation)
- **03‑21**: Remaining macrostructures using Arabic numerals

This labeling convention appears consistent across the `skills/hallmark/references/` directory, where each macrostructure maintains its own dedicated definition file following the pattern established by [`02-long-document.md`](https://github.com/Nutlope/hallmark/blob/main/02-long-document.md).

## Summary

- Hallmark contains exactly **21 named macrostructures** documented in [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md).
- The **Long Document** (02) carries the unique Roman numeral **II** designation among otherwise Arabic-numbered templates.
- Long Document pages use continuous prose formatting suitable for memos and letters, defined in [`skills/hallmark/references/macrostructures/02-long-document.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures/02-long-document.md).
- Each macrostructure follows a standardized definition pattern with dedicated reference files in the macrostructures directory.

## Frequently Asked Questions

### What file contains the complete list of the 21 Hallmark macrostructures?

The definitive index is located at [`skills/hallmark/references/macrostructures.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures.md), which enumerates all 21 named templates including their numerical identifiers and descriptive names.

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

While the Long Document is sequentially numbered 02 in the Arabic sequence, it is uniquely labeled with the Roman numeral **II** in Hallmark’s design system documentation, distinguishing it as a prose-heavy format distinct from standard page layouts.

### How is the Long Document macrostructure typically used?

According to the source definition in [`skills/hallmark/references/macrostructures/02-long-document.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures/02-long-document.md), this macrostructure serves memo, letter, and journal-entry content that requires inline section headings without hero imagery or marketing layout interruptions.

### Are all Hallmark macrostructures defined in individual files?

Yes, following the pattern established by the Long Document at [`skills/hallmark/references/macrostructures/02-long-document.md`](https://github.com/Nutlope/hallmark/blob/main/skills/hallmark/references/macrostructures/02-long-document.md), each of the 21 macrostructures has its own dedicated reference file detailing layout rules, heading hierarchies, and typical content patterns.