What Are the 21 Named Macrostructures in Hallmark?

Hallmark defines 21 standardized document templates called macrostructures, cataloged in 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. 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, 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:

/* Hallmark · macrostructure: Long Document */

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

Summary

• Hallmark contains exactly 21 named macrostructures documented in 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.
• 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, 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, 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, each of the 21 macrostructures has its own dedicated reference file detailing layout rules, heading hierarchies, and typical content patterns.

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