| name | markbind-reuse |
| description | Use when reusing content across pages with includes, defining variables, creating boilerplate templates, sharing content between sites, creating content variations, or when users ask about content reuse, DRY patterns, includes, variables, or templates in MarkBind |
| paths | *.md,*.html |
MarkBind Content Reuse
Overview
MarkBind is optimized for content reuse through includes, boilerplates, variables, and page-variation features.
Essential Rules
- Include paths are resolved relative to the included file's original location, not the caller page.
- Boilerplates in
_markbind/boilerplates/ are interpreted relative to where they are applied.
- Global variables in
_markbind/variables.md / _markbind/variables.json are available site-wide.
- Global variables take precedence over include-scoped variables; outer include variables override inner ones.
- If fragments are meant only for reuse, exclude them from rendering via
pagesExclude.
Reuse References
- reference/includes.md - how to use
<include> with fragments and attributes (inline, optional, trim, omitFrontmatter), pass include-scoped variables, and avoid path-resolution surprises.
- reference/boilerplates.md - how to author reusable templates in
_markbind/boilerplates/, apply them in different directories, and pass values into boilerplate placeholders.
- reference/variables.md - page-scoped variables, global variables, built-in variables (
baseUrl, timestamp, MarkBind), external JSON/CSV data via {% ext %}, and escaping raw Nunjucks syntax.
- reference/reuse-patterns.md - practical patterns for sharing content across pages/sites and keeping reusable fragments out of generated page lists.
- reference/content-variations.md - reader-facing variation techniques using tags, tabs, closeable sections, hidden fragments, and print-friendly controls.
- reference/search-indexing.md - search-targeting techniques using keyword spans, page-level keywords, and heading index controls (
.always-index, .no-index).
User Guide Entry