diff --git a/examples/sample-docs/projects/_shared/src/fragment-example.html b/examples/sample-docs/projects/_shared/src/fragment-example.html
new file mode 100644
index 0000000..adbb470
--- /dev/null
+++ b/examples/sample-docs/projects/_shared/src/fragment-example.html
@@ -0,0 +1,2 @@
+<!-- This HTML fragment will be inserted into the `<head>` element when the Markdown page -->
+<!-- includes `fragment: head: ['example']` in the frontmatter. -->
diff --git a/examples/sample-docs/projects/_shared/src/template-default.html b/examples/sample-docs/projects/_shared/src/template-default.html
index 14402fa..5a67d16 100644
--- a/examples/sample-docs/projects/_shared/src/template-default.html
+++ b/examples/sample-docs/projects/_shared/src/template-default.html
@@ -24,6 +24,8 @@
   <script src="${ASSET-search.js}"></script>
   <script src="${ASSET-support.js}"></script>
 
+<!-- {HEAD FRAGMENTS} -->
+
   <script>
     function onSearch(searchTerm) {
       performSearch(searchTerm, '${BASE_PATH}');
diff --git a/examples/sample-docs/projects/sample-guide/content/page_1.md b/examples/sample-docs/projects/sample-guide/content/page_1.md
index 0251ff1..9bd6467 100644
--- a/examples/sample-docs/projects/sample-guide/content/page_1.md
+++ b/examples/sample-docs/projects/sample-guide/content/page_1.md
@@ -1,3 +1,8 @@
+---
+fragments:
+  head: ['example']
+---
+
 # <!-- section:page_1 --><!-- def:title -->Page 1
 
 <!-- def:intro -->
diff --git a/packages/docs-builder/package.json b/packages/docs-builder/package.json
index b655f90..edf0aca 100644
--- a/packages/docs-builder/package.json
+++ b/packages/docs-builder/package.json
@@ -39,6 +39,7 @@
     "find-up": "^6.3.0",
     "gettext-parser": "^5.0.0",
     "glob": "^8.0.3",
+    "gray-matter": "^4.0.3",
     "lunr": "^2.3.9",
     "lunr-languages": "^1.9.0",
     "mark.js": "^8.11.1",
diff --git a/packages/docs-builder/src/gen-html.ts b/packages/docs-builder/src/gen-html.ts
index d73dceb..d479f63 100644
--- a/packages/docs-builder/src/gen-html.ts
+++ b/packages/docs-builder/src/gen-html.ts
@@ -127,13 +127,17 @@ export function generateHtml(context: Context, mdRelPath: string, mdPage: Markdo
   // Convert the Markdown content to HTML
   const body = convertMarkdownToHtml(context, md)
 
+  // Save the names of the `<head>` fragments to include
+  const headFragments = mdPage.frontmatter?.fragments?.head || []
+
   // Clear the current page
   context.setCurrentPage(undefined)
 
   return {
     baseName,
     relPath: htmlRelPath,
-    body
+    body,
+    headFragments
   }
 }
 
@@ -308,7 +312,17 @@ export function writeHtmlFile(
   // Build the final HTML file by replacing fields in the template
   const templateFile = `template-${templateName}.html`
   const templatePath = resolvePath(context.config.sourceDir, templateFile)
-  const htmlTemplate = readTextFile(templatePath)
+  const htmlTemplateRaw = readTextFile(templatePath)
+  let headSlot = ''
+  if (htmlPage.headFragments) {
+    // Insert fragments into the `<head>` slot
+    for (const fragmentName of htmlPage.headFragments) {
+      const fragmentPath = resolvePath(context.config.sourceDir, `fragment-${fragmentName}.html`)
+      const fragmentHtml = readTextFile(fragmentPath)
+      headSlot += fragmentHtml + '\n'
+    }
+  }
+  const htmlTemplate = htmlTemplateRaw.replace('<!-- {HEAD FRAGMENTS} -->', headSlot)
   const html = htmlTemplate.replaceAll(/\${([a-zA-Z0-9._-]*)}/g, (_substring, id) => {
     if (id.startsWith('ASSET-')) {
       // Assets are specified like `${ASSET-my-image.png}`; remap to the full relative path to
diff --git a/packages/docs-builder/src/parse.ts b/packages/docs-builder/src/parse.ts
index 0839876..284e104 100644
--- a/packages/docs-builder/src/parse.ts
+++ b/packages/docs-builder/src/parse.ts
@@ -1,7 +1,9 @@
 // Copyright (c) 2022 Climate Interactive / New Venture Fund
 
 import { resolve } from 'path'
+import matter from 'gray-matter'
 import { marked } from 'marked'
+
 import type { BlockId } from './block'
 import type { Command } from './command'
 import type { Context } from './context'
@@ -46,7 +48,12 @@ export function parseMarkdownPage(context: Context, relPath: string): MarkdownPa
 
   // Read the Markdown file
   const filePath = resolve(context.config.baseProjDir, relPath)
-  const origMarkdown = readTextFile(filePath)
+  const origMarkdownWithFrontmatter = readTextFile(filePath)
+
+  // Separate frontmatter from the content
+  const origMarkdownSeparated = matter(origMarkdownWithFrontmatter)
+  const origMarkdown = origMarkdownSeparated.content
+  const frontmatter = origMarkdownSeparated.data
 
   // Append synthesized link info for glossary references so that source files can
   // use `[link text][glossary_term]` without manually defining a reference for
@@ -81,7 +88,8 @@ export function parseMarkdownPage(context: Context, relPath: string): MarkdownPa
   context.setCurrentPage(undefined)
 
   return {
-    raw: outMarkdown
+    raw: outMarkdown,
+    frontmatter
   }
 }
 
diff --git a/packages/docs-builder/src/types.ts b/packages/docs-builder/src/types.ts
index 4dfb084..b755e4b 100644
--- a/packages/docs-builder/src/types.ts
+++ b/packages/docs-builder/src/types.ts
@@ -2,12 +2,20 @@
 
 export type LangCode = string
 
+export type Frontmatter = {
+  fragments?: {
+    head?: string[]
+  }
+}
+
 export interface MarkdownPage {
   raw: string
+  frontmatter?: Frontmatter
 }
 
 export interface HtmlPage {
   baseName: string
   relPath: string
   body: string
+  headFragments?: string[]
 }
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index d84a5ec..49438a1 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -62,6 +62,9 @@ importers:
       glob:
         specifier: ^8.0.3
         version: 8.0.3
+      gray-matter:
+        specifier: ^4.0.3
+        version: 4.0.3
       lunr:
         specifier: ^2.3.9
         version: 2.3.9
@@ -889,6 +892,12 @@ packages:
     engines: {node: '>=8'}
     dev: false
 
+  /argparse@1.0.10:
+    resolution: {integrity: sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==}
+    dependencies:
+      sprintf-js: 1.0.3
+    dev: false
+
   /argparse@2.0.1:
     resolution: {integrity: sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==}
     dev: true
@@ -1431,6 +1440,12 @@ packages:
       eslint-visitor-keys: 3.4.3
     dev: true
 
+  /esprima@4.0.1:
+    resolution: {integrity: sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A==}
+    engines: {node: '>=4'}
+    hasBin: true
+    dev: false
+
   /esquery@1.5.0:
     resolution: {integrity: sha512-YQLXUplAwJgCydQ78IMJywZCceoqk1oH01OERdSAJc/7U2AylwjhSCLDEtqwg811idIS/9fIU5GjG73IgjKMVg==}
     engines: {node: '>=0.10'}
@@ -1520,6 +1535,13 @@ packages:
       strip-final-newline: 3.0.0
     dev: true
 
+  /extend-shallow@2.0.1:
+    resolution: {integrity: sha512-zCnTtlxNoAiDc3gqY2aYAWFx7XWWiasuF2K8Me5WbN8otHKTUKBwjPtNpRs/rbUZm7KxWAaNj7P1a/p52GbVug==}
+    engines: {node: '>=0.10.0'}
+    dependencies:
+      is-extendable: 0.1.1
+    dev: false
+
   /extract-zip@2.0.1:
     resolution: {integrity: sha512-GDhU9ntwuKyGXdZBUgTIe+vXnWj0fppUEtMDL0+idd5Sta8TGpHssn/eusA9mrPr9qNDym6SxAYZjNvCn/9RBg==}
     engines: {node: '>= 10.17.0'}
@@ -1800,6 +1822,16 @@ packages:
     resolution: {integrity: sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==}
     dev: true
 
+  /gray-matter@4.0.3:
+    resolution: {integrity: sha512-5v6yZd4JK3eMI3FqqCouswVqwugaA9r4dNZB1wwcmrD02QkV5H0y7XBQW8QwQqEaZY1pM9aqORSORhJRdNK44Q==}
+    engines: {node: '>=6.0'}
+    dependencies:
+      js-yaml: 3.14.1
+      kind-of: 6.0.3
+      section-matter: 1.0.0
+      strip-bom-string: 1.0.0
+    dev: false
+
   /has-bigints@1.0.2:
     resolution: {integrity: sha512-tSvCKtBr9lkF0Ex0aQiP9N+OpV4zi2r/Nee5VkRDbaqv35RLYMzbwQfFSZZH0kR+Rd6302UJZ2p/bJCEoR3VoQ==}
     dev: true
@@ -2013,6 +2045,11 @@ packages:
     hasBin: true
     dev: false
 
+  /is-extendable@0.1.1:
+    resolution: {integrity: sha512-5BMULNob1vgFX6EjQw5izWDxrecWK9AM72rugNr0TFldMOi0fj6Jk+zeKIt0xGj4cEfQIJth4w3OKWOJ4f+AFw==}
+    engines: {node: '>=0.10.0'}
+    dev: false
+
   /is-extglob@2.1.1:
     resolution: {integrity: sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==}
     engines: {node: '>=0.10.0'}
@@ -2122,6 +2159,14 @@ packages:
     resolution: {integrity: sha512-UfJMcSJc+SEXEl9lH/VLHSZbThQyLpw1vLO1Lb+j4RWDvG3N2f7yj3PVQA3cmkTBNldJ9eFnM+xEXxHIXrYiJw==}
     dev: true
 
+  /js-yaml@3.14.1:
+    resolution: {integrity: sha512-okMH7OXXJ7YrN9Ok3/SXrnu4iX9yOk+25nqX4imS2npuvTYDmo/QEZoqwZkYaIDk3jVvBOTOIEgEhaLOynBS9g==}
+    hasBin: true
+    dependencies:
+      argparse: 1.0.10
+      esprima: 4.0.1
+    dev: false
+
   /js-yaml@4.1.0:
     resolution: {integrity: sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==}
     hasBin: true
@@ -2145,6 +2190,11 @@ packages:
     resolution: {integrity: sha512-AilxAyFOAcK5wA1+LeaySVBrHsGQvUFCDWXKpZjzaL0PqW+xfBOttn8GNtWKFWqneyMZj41MWF9Kl6iPWLwgOA==}
     dev: true
 
+  /kind-of@6.0.3:
+    resolution: {integrity: sha512-dcS1ul+9tmeD95T+x28/ehLgd9mENa3LsvDTtzm3vyBEO7RPptvAD+t44WVXaUjTBRcrpFeFlC8WCruUR456hw==}
+    engines: {node: '>=0.10.0'}
+    dev: false
+
   /levn@0.4.1:
     resolution: {integrity: sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==}
     engines: {node: '>= 0.8.0'}
@@ -2929,6 +2979,14 @@ packages:
     resolution: {integrity: sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==}
     dev: false
 
+  /section-matter@1.0.0:
+    resolution: {integrity: sha512-vfD3pmTzGpufjScBh50YHKzEu2lxBWhVEHsNGoEXmCmn2hKGfeNLYMzCJpe8cD7gqX7TJluOVpBkAequ6dgMmA==}
+    engines: {node: '>=4'}
+    dependencies:
+      extend-shallow: 2.0.1
+      kind-of: 6.0.3
+    dev: false
+
   /semver-compare@1.0.0:
     resolution: {integrity: sha512-YM3/ITh2MJ5MtzaM429anh+x2jiLVjqILF4m4oyQB18W7Ggea7BfqdH/wGMK7dDiMghv/6WG7znWMwUDzJiXow==}
     dev: false
@@ -3090,6 +3148,10 @@ packages:
       through: 2.3.8
     dev: false
 
+  /sprintf-js@1.0.3:
+    resolution: {integrity: sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==}
+    dev: false
+
   /stackback@0.0.2:
     resolution: {integrity: sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==}
     dev: true
@@ -3184,6 +3246,11 @@ packages:
       ansi-regex: 6.0.1
     dev: true
 
+  /strip-bom-string@1.0.0:
+    resolution: {integrity: sha512-uCC2VHvQRYu+lMh4My/sFNmF2klFymLX1wHJeXnbEJERpV/ZsVuonzerjfrGpIGF7LBVa1O7i9kjiWvJiFck8g==}
+    engines: {node: '>=0.10.0'}
+    dev: false
+
   /strip-bom@3.0.0:
     resolution: {integrity: sha512-vavAMRXOgBVNF6nyEEmL3DBK19iRpDcoIwW+swQ+CbGiu7lju6t+JklA1MHweoWtadgt4ISVUsXLyDq34ddcwA==}
     engines: {node: '>=4'}
