diff --git a/docs/devGuide/development/writingPlugins.md b/docs/devGuide/development/writingPlugins.md
index 7af6a5f529..06cf51919e 100644
--- a/docs/devGuide/development/writingPlugins.md
+++ b/docs/devGuide/development/writingPlugins.md
@@ -170,7 +170,8 @@ Tag properties are top-level properties of the tag configuration object. The fol
 
 Property | Values | Default | Remarks
 :----- | ------- | ---- | ----
-`isSpecial` | `true` or `false` | `false` | Allows configuring whether any tag is to be parsed "specially" like a `<script>` or `<style>` tag. This allows configuring custom tags that may contain conflicting syntax, such as the `<puml>` tag used for UML diagram generation.
+`isSpecial` | `true` or `false` | `false` | When `true`, the content inside the tag is treated as raw text and will **not** be parsed as HTML or Markdown (similar to `<script>` or `<style>` tags). Use this for tags containing non-HTML syntax that should not be processed (e.g. `<puml>` for diagrams). Use `false` for standard components that wrap renderable content.
+`customComponent` | `true` or `false` | `false` | Tells the Vue compiler to ignore this tag during compilation. Useful for plugins that introduce custom HTML elements (e.g. Web Components) that should not be resolved as Vue components.
 `attributes` | Array of attribute configurations | `[]` | Contains the attribute configurations of the tags.
 
 **Attribute Properties**
diff --git a/packages/core/src/Page/PageVueServerRenderer.ts b/packages/core/src/Page/PageVueServerRenderer.ts
index b2f52e0786..af52b20390 100644
--- a/packages/core/src/Page/PageVueServerRenderer.ts
+++ b/packages/core/src/Page/PageVueServerRenderer.ts
@@ -14,6 +14,8 @@ import fs from 'fs-extra';
 import * as logger from '../utils/logger';
 import type { PageConfig, PageAssets } from './PageConfig';
 import type { Page } from '.';
+import { PluginManager } from '../plugins/PluginManager';
+
 /* eslint-enable import/no-import-module-exports */
 
 let bundle = require('@markbind/core-web/dist/js/vueCommonAppFactory.min');
@@ -32,11 +34,16 @@ let bundle = require('@markbind/core-web/dist/js/vueCommonAppFactory.min');
  */
 async function compileVuePageCreateAndReturnScript(
   content: string, pageConfig: PageConfig, pageAsset: PageAssets) {
+  const customElementTags = new Set(Object.entries(PluginManager.tagConfig)
+    .filter(([, config]) => config.customComponent)
+    .map(([tagName]) => tagName));
+
   const compilerOptions: CompilerOptions = {
     runtimeModuleName: 'vue',
     runtimeGlobalName: 'Vue',
     mode: 'function',
     whitespace: 'preserve',
+    isCustomElement: tag => customElementTags.has(tag),
   };
 
   const templateOptions: SFCTemplateCompileOptions = {
diff --git a/packages/core/src/plugins/Plugin.ts b/packages/core/src/plugins/Plugin.ts
index 38837e42ae..35fba100f9 100644
--- a/packages/core/src/plugins/Plugin.ts
+++ b/packages/core/src/plugins/Plugin.ts
@@ -26,7 +26,8 @@ type TagConfigAttributes = {
 
 export type TagConfigs = {
   isSpecial: boolean,
-  attributes: TagConfigAttributes[]
+  attributes: TagConfigAttributes[],
+  customComponent?: boolean,
 };
 
 /**