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

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. 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, 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:

/* Hallmark · macrostructure: Long Document */

<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. Individual specifications for each layout pattern reside in dedicated files following the 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 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, 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. 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.

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}