diff --git a/docusaurus.config.ts b/docusaurus.config.ts
index b6b99af5..f58b9566 100644
--- a/docusaurus.config.ts
+++ b/docusaurus.config.ts
@@ -244,6 +244,12 @@ const config: Config = {
 					// conversion sees clean structure. See the script header
 					// for details on what gets transformed.
 					beforeDefaultRehypePlugins: [require('./scripts/rehype-docusaurus-to-llms.mjs').default],
+					// Explicit exclusions for routes that are not real content.
+					// /reference is a client-side redirect React component
+					// (src/pages/reference/index.tsx) that returns null; without
+					// this entry the plugin tries to process its empty HTML
+					// shell and emits a warning.
+					excludeRoutes: ['/reference'],
 				},
 			},
 		],
diff --git a/reference/components/javascript-environment.md b/reference/components/javascript-environment.md
index 3cc8b317..5942b4d4 100644
--- a/reference/components/javascript-environment.md
+++ b/reference/components/javascript-environment.md
@@ -46,7 +46,7 @@ An object containing all databases defined in Harper. Each database is an object
 
 See [Database API](../database/api.md) for full reference.
 
-### `transaction(fn)`
+### `transaction(fn)` {#transaction}
 
 Executes a function inside a database transaction. Changes made within the function are committed atomically, or rolled back if an error is thrown.