Document Macrostructures in Hallmark: A Complete Guide to Document-Type Layouts

Hallmark defines twenty-one landing-page macrostructures, including four document-oriented layouts—Long Document, Manifesto, Quote-Led, and Letter—that shape content-heavy pages through specific structural patterns rather than traditional marketing sections.

The Hallmark framework (available at Nutlope/hallmark) provides a systematic approach to landing-page architecture through predefined macrostructures. While the framework catalogs twenty-one distinct layout patterns, four specific macrostructures prioritize textual narrative and document-style presentation over conventional marketing formats. These document macrostructures determine everything from heading hierarchy to image treatment, ensuring content-heavy pages maintain coherent structural integrity.

The Four Document Macrostructures in Hallmark

Hallmark's complete macrostructure catalog resides in skills/hallmark/references/macrostructures.md, which defines twenty-one total landing-page archetypes. Within this taxonomy, four macrostructures specifically target document-type content delivery:

02 · Long Document

The Long Document macrostructure creates a continuous prose experience resembling a memo, letter, or journal entry. This layout eliminates distinct marketing sections in favor of flowing text with occasional inline headings, making it ideal for briefings, case studies, or white-paper-style presentations where narrative depth outweighs conversion optimization.

07 · Manifesto

The Manifesto macrostructure employs polemical, large-type declarations that establish belief systems before introducing product elements. According to the source code in skills/hallmark/references/macrostructures/07-manifesto.md, this pattern "tells the reader what to believe" through statement-driven editorial tone, fitting activist-style or brand-voice pieces that require strong ideological positioning.

09 · Quote-Led

The Quote-Led macrostructure positions a hero pull-quote with attribution as the primary focal point rather than a traditional headline. As documented in skills/hallmark/references/macrostructures/09-quote-led.md, this layout leverages social proof as the central hook, prioritizing credibility and testimonial impact over direct product messaging.

12 · Letter

The Letter macrostructure utilizes first-person, intimate copy that opens with personal greetings (e.g., "Dear friend, …"). Following the specifications in skills/hallmark/references/macrostructures/12-letter.md, this layout excludes CTAs from the fold and reads as a personal note from a founder, suited for onboarding sequences and personal announcements.

How Hallmark Selects Document Macrostructures

Hallmark employs a four-step selection protocol to determine appropriate macrostructure assignments:

1. Analyze the brief for contextual cues such as "data-heavy," "personal note," or "list of links" that indicate document-style requirements.
2. Audit the codebase for existing comment stamps matching the pattern /* Hallmark · macrostructure: <name> · created: <date> */. The framework enforces a diversification rule preventing consecutive reuse of identical macrostructures within the same project.
3. Match the brief to the most appropriate document-type macrostructure using the "Reach for it" guidelines defined in the reference documentation.
4. Declare the selection before writing code, typically through explicit documentation such as Macrostructure: Letter.

Implementing Document Macrostructures in Code

Hallmark requires specific comment stamps to track macrostructure usage and enforce diversification rules. The following CSS example demonstrates the required annotation format for a Letter macrostructure implementation:

/* Hallmark · macrostructure: Letter · created: 2024‑09‑12 */
body {
  /* document‑oriented styles … */
}

For automated generation workflows, the Hallmark CLI accepts explicit macrostructure parameters:

# Example of invoking Hallmark’s CLI with an explicit macrostructure

hallmark generate --macrostructure=Letter --output=dist/

These implementations illustrate the diversification tracking system and demonstrate how document-type layouts integrate into the Hallmark generation pipeline.

Key Reference Files for Document Layouts

The Hallmark repository maintains granular documentation for each document macrostructure:

• skills/hallmark/references/macrostructures.md — Master catalog of all twenty-one macrostructures including the diversification rules
• skills/hallmark/references/macrostructures/02-long-document.md — Detailed specifications for continuous prose layouts
• skills/hallmark/references/macrostructures/07-manifesto.md — Editorial declaration patterns and typography scales
• skills/hallmark/references/macrostructures/09-quote-led.md — Social-proof hero configurations and attribution styling
• skills/hallmark/references/macrostructures/12-letter.md — First-person voice guidelines and intimate formatting protocols
• skills/hallmark/references/component-cookbook.md — Navigation and footer archetypes that accompany document macrostructures
• skills/hallmark/references/hero-enrichment.md — Optional hero polish patterns combinable with document layouts when hero sections are present

Summary

• Hallmark provides twenty-one macrostructures, with Long Document, Manifesto, Quote-Led, and Letter serving document-oriented content strategies.
• Document macrostructures prioritize narrative flow and textual hierarchy over traditional marketing section breaks.
• The diversification rule prevents consecutive reuse of identical macrostructures, enforced through standardized comment stamps in source files.
• Implementation requires specific file paths within skills/hallmark/references/macrostructures/ for detailed layout guidance.
• Supporting components (navigation, footers, and hero enrichments) are defined in the component cookbook and hero enrichment references.

Frequently Asked Questions

What are the document macrostructures available in Hallmark?

Hallmark provides four document-oriented macrostructures: 02 · Long Document (continuous prose for briefings and white papers), 07 · Manifesto (editorial declarations with large-type statements), 09 · Quote-Led (social-proof focused layouts centered on testimonials), and 12 · Letter (first-person intimate communications). These are documented in skills/hallmark/references/macrostructures.md alongside seventeen additional landing-page patterns.

How does Hallmark prevent repetitive use of the same macrostructure?

Hallmark enforces a diversification rule that prohibits reusing identical macrostructures consecutively within the same project. The framework tracks usage through standardized CSS comment stamps formatted as /* Hallmark · macrostructure: <name> · created: <date> */. Developers must audit existing code for these stamps before selecting a macrostructure for new pages.

Where are document macrostructures defined in the Hallmark repository?

Document macrostructures are defined in skills/hallmark/references/macrostructures.md, which serves as the master catalog. Individual specifications reside in dedicated files within skills/hallmark/references/macrostructures/, specifically 02-long-document.md, 07-manifesto.md, 09-quote-led.md, and 12-letter.md. Supporting navigation and footer patterns are documented in skills/hallmark/references/component-cookbook.md.

Can document macrostructures be combined with hero sections?

Yes. While document macrostructures like Letter and Long Document typically minimize traditional marketing elements, they can incorporate hero sections when combined with patterns from skills/hallmark/references/hero-enrichment.md. This reference file defines optional hero polish patterns that layer atop document layouts, allowing for testimonials (Quote-Led) or founder imagery (Letter) without disrupting the document-style narrative flow.

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