Recommend a JS config file for defining tags

Gerrit0 · Gerrit0 · commit fe89773e565f · 2026-02-25T21:28:33.000-07:00
diff --git a/site/tags.md b/site/tags.md
@@ -88,6 +88,33 @@ the file **must** be placed alongside `tsconfig.json`. See the
 }
 ```
 
+When defining tags in a TypeDoc configuration file, it is recommended to use a JavaScript
+config file so that TypeDoc's default tag list can be easily extended.
+
+```js
+// typedoc.config.mjs
+import { OptionDefaults } from "typedoc";
+/** @import { TypeDocOptions } from "typedoc" */
+
+/** @type {TypeDocOptions} */
+const config = {
+    blockTags: [
+        ...OptionDefaults.blockTags,
+        "@customBlock",
+    ],
+    modifierTags: [
+        ...OptionDefaults.modifierTags,
+        "@customModifier",
+    ],
+    inlineTags: [
+        ...OptionDefaults.inlineTags,
+        "@customInline",
+    ],
+};
+
+export default config;
+```
+
 ## Block Tags
 
 Block tags are tags that are associated with the following text. They can be
