Learn

Use Learn to understand and apply the system. Use Standards when you need the governing contract.

Reusable Template Composition

Build markdown-template structures from small, repeatable section patterns so reader-facing documents stay maintainable.

Pattern

How report-structure reuse should work

Reuse is valuable when it makes repeated markdown structure easier to reason about, not when it hides the report shape.

1Identify stable repeated sections

Look for structure that repeats because the content shape is actually consistent.

2Extract a reusable section pattern

Move the repeated markdown structure into a named section pattern with an obvious purpose.

3Keep structure readable

Make it easy for a reader to trace the repeated heading, table, or list shape.

4Compose the full report shape

Use the smaller patterns to reduce duplication without creating a hidden second schema.

If reuse obscures the render path, it is not helping.

Template schemas are easier to maintain when repeated narrative shapes are assembled from smaller structural patterns instead of copied into many places.

Pattern

  • Identify repeated sections.
  • Reuse shared heading, table, and list patterns when the reader-visible shape is genuinely stable.
  • Keep the authored markdown structure simple enough that a reader can trace it without guessing.
  • Reuse structure when the content shape is stable, not when it is only accidentally similar.

What To Watch

  • A reused report section should stay obvious in purpose.
  • A template should not become an implied second data model.
  • Reuse should reduce duplication, not obscure the render path.

Use This When

  • the same content block appears in multiple outputs
  • the document family is expected to evolve over time
  • you want template changes to stay local and understandable