diff --git a/.gitignore b/.gitignore
index 7fdacb4a9ee..f75387f17e1 100644
--- a/.gitignore
+++ b/.gitignore
@@ -109,5 +109,6 @@ yarn.lock
 
 cypress/screenshots
 cypress/videos
+.playwright-mcp/
 
 _local/
diff --git a/docs/.vitepress/components/api-docs/refreshable-code.vue b/docs/.vitepress/components/api-docs/refreshable-code.vue
index 23cfcc87fd7..1f39c95a2bc 100644
--- a/docs/.vitepress/components/api-docs/refreshable-code.vue
+++ b/docs/.vitepress/components/api-docs/refreshable-code.vue
@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { computed, onMounted, ref, useTemplateRef } from 'vue';
+import { onMounted, ref, useTemplateRef } from 'vue';
 import { formatResult } from './format';
 import RefreshButton from './refresh-button.vue';
 
@@ -14,14 +14,13 @@ const {
 }>();
 
 const code = useTemplateRef('code');
-const codeBlock = computed(() => code.value?.querySelector('div pre code'));
 const codeLines = ref<Element[]>();
 
 function initRefresh(): Element[] {
-  if (codeBlock.value == null) {
+  if (code.value == null) {
     return [];
   }
-  const domLines = codeBlock.value.querySelectorAll('.line');
+  const domLines = code.value.querySelectorAll('.line');
   let lineIndex = 0;
   const result: Element[] = [];
   while (lineIndex < domLines.length) {
@@ -82,13 +81,13 @@ function initRefresh(): Element[] {
 }
 
 async function onRefresh(): Promise<void> {
-  if (refresh != null && codeBlock.value != null) {
+  if (refresh != null && code.value != null) {
     codeLines.value ??= initRefresh();
 
     const results = await refresh();
 
     // Remove old comments
-    codeBlock.value
+    code.value
       .querySelectorAll('.comment-delete-marker')
       .forEach((el) => el.remove());
 
diff --git a/scripts/apidocs/output/page.ts b/scripts/apidocs/output/page.ts
index 4eebc160e52..7e760554cdc 100644
--- a/scripts/apidocs/output/page.ts
+++ b/scripts/apidocs/output/page.ts
@@ -2,7 +2,12 @@ import { writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import type { ApiDocsMethod } from '../../../docs/.vitepress/components/api-docs/method';
 import { formatMarkdown, formatTypescript } from '../../shared/format';
-import { adjustUrls, codeToHtml, mdToHtml } from '../../shared/markdown';
+import {
+  adjustUrls,
+  codeGroupToHtml,
+  codeToHtml,
+  mdToHtml,
+} from '../../shared/markdown';
 import { FILE_PATH_API_DOCS } from '../../shared/paths';
 import { toRefreshableCode } from '../../shared/refreshable-code';
 import type { RawApiDocsPage } from '../processing/class';
@@ -74,7 +79,7 @@ async function writePageMarkdown(page: RawApiDocsPage): Promise<void> {
 
   ${adjustUrls(description)}
 
-  ${examples.length === 0 ? '' : `<div class="examples">${await codeToHtml(examples.join('\n'))}</div>`}
+  ${examples.length === 0 ? '' : `<div class="examples">${await codeGroupToHtml(examples)}</div>`}
 
   :::
 
@@ -199,7 +204,7 @@ async function toMethodData(method: RawApiDocsMethod): Promise<ApiDocsMethod> {
       throws.length === 0 ? undefined : await mdToHtml(throws.join('\n'), true),
     returns: returns.text,
     signature: await codeToHtml(formattedSignature),
-    examples: await codeToHtml(examples.join('\n')),
+    examples: await codeGroupToHtml(examples),
     refresh,
     deprecated: await mdToHtml(deprecated),
     seeAlsos: await Promise.all(
diff --git a/scripts/shared/markdown.ts b/scripts/shared/markdown.ts
index e2f4ccab18f..bddca2ca545 100644
--- a/scripts/shared/markdown.ts
+++ b/scripts/shared/markdown.ts
@@ -20,6 +20,8 @@ const htmlSanitizeOptions: sanitizeHtml.IOptions = {
     'button',
     'code',
     'div',
+    'input',
+    'label',
     'li',
     'p',
     'pre',
@@ -37,13 +39,15 @@ const htmlSanitizeOptions: sanitizeHtml.IOptions = {
     a: ['href', 'target', 'rel'],
     button: ['class', 'title'],
     div: ['class'],
+    input: ['type', 'name', 'id', 'checked'],
+    label: ['for', 'data-title'],
     pre: ['class', 'dir', 'style', 'v-pre', 'tabindex'],
     span: ['class', 'style'],
     table: ['tabindex'],
     th: ['style'],
     td: ['style'],
   },
-  selfClosing: [],
+  selfClosing: ['input'],
 };
 
 function comparableSanitizedHtml(html: string): string {
@@ -55,6 +59,7 @@ function comparableSanitizedHtml(html: string): string {
     .replaceAll('&lt;', '<')
     .replaceAll('&amp;', '&')
     .replaceAll('=""', '')
+    .replaceAll('/>', '>')
     .replaceAll(' ', '');
 }
 
@@ -81,6 +86,54 @@ export async function codeToHtml(code: string): Promise<string> {
   return mdToHtml(wrapCode(code));
 }
 
+/**
+ * Converts a list of Typescript code blocks to a tabbed VitePress code group
+ * and returns the rendered, sanitized HTML.
+ *
+ * If only a single code block is provided, a plain code block is rendered
+ * instead so we don't emit an unnecessary tab strip.
+ *
+ * When multiple code blocks are provided, each block's first line must be a
+ * single-line `//` comment that is used as the tab title. This keeps the tab
+ * titles visible in JSDoc-driven IDE tooltips without introducing any
+ * docs-site-only metadata in the source.
+ *
+ * @param codes The code blocks to convert.
+ *
+ * @returns The converted HTML string.
+ */
+export async function codeGroupToHtml(codes: string[]): Promise<string> {
+  if (codes.length <= 1) {
+    return codeToHtml(codes.join('\n'));
+  }
+
+  const delimiter = '```';
+  const blocks = codes
+    .map((code, index) => {
+      const { title, body } = extractCodeGroupTitle(code, index);
+      return `${delimiter}ts [${title}]\n${body}\n${delimiter}`;
+    })
+    .join('\n\n');
+  return mdToHtml(`::: code-group\n\n${blocks}\n\n:::`);
+}
+
+function extractCodeGroupTitle(
+  code: string,
+  index: number
+): { title: string; body: string } {
+  const newlineIndex = code.indexOf('\n');
+  const firstLine = newlineIndex === -1 ? '' : code.slice(0, newlineIndex);
+  if (!firstLine.startsWith('// ')) {
+    throw new Error(
+      `Example ${index + 1} in a multi-example block must start with a \`// Title\` line comment to label the code-group tab, but got:\n${code}`
+    );
+  }
+
+  const body = code.slice(newlineIndex + 1);
+
+  return { title: firstLine.substring(3), body };
+}
+
 /**
  * Converts Markdown to an HTML string and sanitizes it.
  *
diff --git a/src/faker.ts b/src/faker.ts
index 18352f37261..8bc4256357b 100644
--- a/src/faker.ts
+++ b/src/faker.ts
@@ -35,6 +35,7 @@ import { SimpleFaker } from './simple-faker';
  * Please have a look at the individual modules and methods for more information and examples.
  *
  * @example
+ * // Default Faker instance
  * import { faker } from '@faker-js/faker';
  * // const { faker } = require('@faker-js/faker');
  *
@@ -43,6 +44,7 @@ import { SimpleFaker } from './simple-faker';
  * faker.person.firstName(); // 'John'
  * faker.person.lastName(); // 'Doe'
  * @example
+ * // Custom locale without en fallback
  * import { Faker, es } from '@faker-js/faker';
  * // const { Faker, es } = require('@faker-js/faker');
  *
diff --git a/test/scripts/apidocs/__snapshots__/class.spec.ts.snap b/test/scripts/apidocs/__snapshots__/class.spec.ts.snap
index 6461169d134..dc9cc826a3c 100644
--- a/test/scripts/apidocs/__snapshots__/class.spec.ts.snap
+++ b/test/scripts/apidocs/__snapshots__/class.spec.ts.snap
@@ -5,6 +5,7 @@ exports[`class > expected and actual modules are equal 1`] = `
   "ModuleDeprecationTest",
   "ModuleExampleTest",
   "ModuleFakerJsLinkTest",
+  "ModuleMultipleExamplesTest",
   "ModuleNextFakerJsLinkTest",
   "ModuleSimpleTest",
 ]
@@ -49,6 +50,24 @@ and [api docs](https://fakerjs.dev/api/).",
 }
 `;
 
+exports[`class > processClass(ModuleMultipleExamplesTest) 1`] = `
+{
+  "camelTitle": "moduleMultipleExamplesTest",
+  "category": undefined,
+  "deprecated": undefined,
+  "description": "This is a description for a module with multiple code examples.",
+  "examples": [
+    "// Basic instantiation
+new ModuleMultipleExamplesTest()",
+    "// Stateful usage
+const instance = new ModuleMultipleExamplesTest();
+instance.doSomething();",
+  ],
+  "methods": [],
+  "title": "ModuleMultipleExamplesTest",
+}
+`;
+
 exports[`class > processClass(ModuleNextFakerJsLinkTest) 1`] = `
 {
   "camelTitle": "moduleNextFakerJsLinkTest",
diff --git a/test/scripts/apidocs/__snapshots__/method.spec.ts.snap b/test/scripts/apidocs/__snapshots__/method.spec.ts.snap
index 472a427c9e3..3cbfc0b2483 100644
--- a/test/scripts/apidocs/__snapshots__/method.spec.ts.snap
+++ b/test/scripts/apidocs/__snapshots__/method.spec.ts.snap
@@ -9,6 +9,7 @@ exports[`method > expected and actual methods are equal 1`] = `
   "methodWithDeprecated",
   "methodWithDeprecatedOption",
   "methodWithExample",
+  "methodWithMultipleExamples",
   "methodWithMultipleRemarks",
   "methodWithMultipleSeeMarkers",
   "methodWithMultipleSeeMarkersAndBackticks",
@@ -604,6 +605,40 @@ exports[`method > processMethodLike(methodWithExample) 1`] = `
 }
 `;
 
+exports[`method > processMethodLike(methodWithMultipleExamples) 1`] = `
+{
+  "name": "methodWithMultipleExamples",
+  "signatures": [
+    {
+      "deprecated": undefined,
+      "description": "Test with multiple example markers.",
+      "examples": [
+        "// Inline usage
+test.apidocs.methodWithMultipleExamples() // 0",
+        "// Stored in a variable
+const value = test.apidocs.methodWithMultipleExamples();
+console.log(value); // 0",
+      ],
+      "parameters": [],
+      "remarks": [],
+      "returns": {
+        "text": "number",
+        "type": "simple",
+      },
+      "seeAlsos": [],
+      "signature": "function methodWithMultipleExamples(): number;",
+      "since": "1.0.0",
+      "throws": [],
+    },
+  ],
+  "source": {
+    "column": -1,
+    "filePath": "test/scripts/apidocs/method.example.ts",
+    "line": -1,
+  },
+}
+`;
+
 exports[`method > processMethodLike(methodWithMultipleRemarks) 1`] = `
 {
   "name": "methodWithMultipleRemarks",
diff --git a/test/scripts/apidocs/class.example.ts b/test/scripts/apidocs/class.example.ts
index 0e5d9d89613..246ba5070c4 100644
--- a/test/scripts/apidocs/class.example.ts
+++ b/test/scripts/apidocs/class.example.ts
@@ -31,3 +31,16 @@ export class ModuleDeprecationTest {}
  * new ModuleExampleTest()
  */
 export class ModuleExampleTest {}
+
+/**
+ * This is a description for a module with multiple code examples.
+ *
+ * @example
+ * // Basic instantiation
+ * new ModuleMultipleExamplesTest()
+ * @example
+ * // Stateful usage
+ * const instance = new ModuleMultipleExamplesTest();
+ * instance.doSomething();
+ */
+export class ModuleMultipleExamplesTest {}
diff --git a/test/scripts/apidocs/method.example.ts b/test/scripts/apidocs/method.example.ts
index f72b767821a..1a1e19c01fd 100644
--- a/test/scripts/apidocs/method.example.ts
+++ b/test/scripts/apidocs/method.example.ts
@@ -347,6 +347,23 @@ export class SignatureTest {
     return 0;
   }
 
+  /**
+   * Test with multiple example markers.
+   *
+   * @example
+   * // Inline usage
+   * test.apidocs.methodWithMultipleExamples() // 0
+   * @example
+   * // Stored in a variable
+   * const value = test.apidocs.methodWithMultipleExamples();
+   * console.log(value); // 0
+   *
+   * @since 1.0.0
+   */
+  methodWithMultipleExamples(): number {
+    return 0;
+  }
+
   /**
    * Test with deprecated and see marker.
    *
diff --git a/test/scripts/shared/__snapshots__/markdown.spec.ts.snap b/test/scripts/shared/__snapshots__/markdown.spec.ts.snap
new file mode 100644
index 00000000000..bca5942398e
--- /dev/null
+++ b/test/scripts/shared/__snapshots__/markdown.spec.ts.snap
@@ -0,0 +1,19 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`markdown > codeGroupToHtml() > renders a plain code block for a single example 1`] = `
+"<div class="language-ts"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e" tabindex="0" dir="ltr" v-pre><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> a</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> =</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> 1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">;</span></span></code></pre>
+</div>"
+`;
+
+exports[`markdown > codeGroupToHtml() > renders a tabbed code group with titles from leading comments 1`] = `
+"<div class="vp-code-group"><div class="tabs"><input type="radio" name="group-0" id="tab-1" checked /><label data-title="First title" for="tab-1">First title</label><input type="radio" name="group-0" id="tab-2" /><label data-title="Second title" for="tab-2">Second title</label></div><div class="blocks">
+<div class="language-ts active"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e" tabindex="0" dir="ltr" v-pre><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> a</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> =</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> 1</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">;</span></span></code></pre>
+</div><div class="language-ts"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e" tabindex="0" dir="ltr" v-pre><code><span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583">const</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> b</span><span style="--shiki-light:#D73A49;--shiki-dark:#F97583"> =</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF"> 2</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8">;</span></span></code></pre>
+</div></div></div>
+"
+`;
+
+exports[`markdown > codeGroupToHtml() > throws when a multi-example block is missing a title comment 1`] = `
+[Error: Example 2 in a multi-example block must start with a \`// Title\` line comment to label the code-group tab, but got:
+const b = 2;]
+`;
diff --git a/test/scripts/shared/markdown.spec.ts b/test/scripts/shared/markdown.spec.ts
new file mode 100644
index 00000000000..a862f06f25a
--- /dev/null
+++ b/test/scripts/shared/markdown.spec.ts
@@ -0,0 +1,34 @@
+import { beforeAll, describe, expect, it } from 'vitest';
+import {
+  codeGroupToHtml,
+  initMarkdownRenderer,
+} from '../../../scripts/shared/markdown';
+
+describe('markdown', () => {
+  beforeAll(async () => {
+    await initMarkdownRenderer();
+  });
+
+  describe('codeGroupToHtml()', () => {
+    it('renders a plain code block for a single example', async () => {
+      const html = await codeGroupToHtml(['const a = 1;']);
+
+      expect(html).toMatchSnapshot();
+    });
+
+    it('renders a tabbed code group with titles from leading comments', async () => {
+      const html = await codeGroupToHtml([
+        '// First title\nconst a = 1;',
+        '// Second title\nconst b = 2;',
+      ]);
+
+      expect(html).toMatchSnapshot();
+    });
+
+    it('throws when a multi-example block is missing a title comment', async () => {
+      await expect(
+        codeGroupToHtml(['// First title\nconst a = 1;', 'const b = 2;'])
+      ).rejects.toThrowErrorMatchingSnapshot();
+    });
+  });
+});