@intlayer/docs 8.9.8 → 8.10.0-canary.1

package/docs/zh/dictionary/markdown.md

@@ -1,8 +1,8 @@
 ---
 createdAt: 2025-02-07
-updatedAt: 2026-03-24
+updatedAt: 2026-05-19
 title: Markdown
-description: 了解如何在多语言网站中使用Intlayer声明和使用Markdown内容。按照此在线文档中的步骤，将Markdown无缝集成到您的项目中。
+description: 了解如何使用 Intlayer 在您的多语言网站中声明和使用 Markdown 内容。按照本在线文档中的步骤将 Markdown 无缝集成到您的项目中。
 keywords:
   - Markdown
   - 国际化
@@ -17,34 +17,69 @@ slugs:
   - content
   - markdown
 history:
+  - version: 8.10.0
+    date: 2026-05-19
+    changes: "添加对 `.content.md` 文件的支持"
   - version: 8.5.0
     date: 2026-03-24
-    changes: "Add `intlayerMarkdown` plugin object; use `app.use(intlayerMarkdown)` instead of `app.use(installIntlayerMarkdown)`"
+    changes: "添加 `intlayerMarkdown` 插件对象；使用 `app.use(intlayerMarkdown)` 代替 `app.use(installIntlayerMarkdown)`"
   - version: 8.5.0
     date: 2026-03-24
-    changes: "将导入从 {{framework}}-intlayer 移动到 {{framework}}-intlayer/markdown"
+    changes: "将导入从 `{{framework}}-intlayer` 移动到 `{{framework}}-intlayer/markdown`"
   - version: 8.0.0
     date: 2026-01-22
-    changes: "添加 MarkdownRenderer / useMarkdownRenderer / renderMarkdown 实用工具和 forceInline 选项"
+    changes: "添加 MarkdownRenderer / useMarkdownRenderer / renderMarkdown 实用程序和 forceInline 选项"
   - version: 8.0.0
     date: 2026-01-18
-    changes: "自动装饰 markdown 内容，支持 MDX 和 SSR"
+    changes: "Markdown 内容的自动装饰，MDX 和 SSR 支持"
   - version: 5.5.10
     date: 2025-06-29
-    changes: "初始化历史记录"
+    changes: "初始化历史"
 ---
 
 # Markdown / 富文本内容
 
-Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻松编写和维护具有丰富格式的内容，例如博客、文章等。
+Intlayer 支持使用 Markdown 语法定义的富文本内容。这使您可以轻松编写和维护具有丰富格式的内容，例如博客、文章等。
 
 ## 声明 Markdown 内容
 
-您可以使用 `md` 函数声明 Markdown 内容，或简单地将其作为字符串（如果它包含 Markdown 语法）。
+您可以使用 `md` 函数声明 Markdown 内容，或简单地将其作为字符串声明（如果它包含 Markdown 语法）。
 
 <Tabs>
-  <Tab label="手动包裹" value="manual-wrapping">
-    使用 `md` 函数显式声明 Markdown 内容。如果您想确保一个字符串被视为 Markdown，即使它不包含明显的语法，这很有用。
+  <Tab label=".content.md" value=".content.md">
+    从 `8.10.0` 版本开始，您可以在 `.content.md` 文件中直接声明 Markdown 内容。Intlayer 会自动检测并解析 Markdown 内容。
+
+    ```md fileName="markdown-file.en.content.md"
+    ---
+    key: my-markdown-content
+    description: 我的内容
+    locale: en
+    ---
+
+    # 我的内容
+
+    这里是一个 Markdown 内容示例
+    ```
+
+    `locale` front-matter 字段是定义内容语言环境的字段。它是可选的。如果没有提供，Intlayer 会使用默认语言环境，如果没有提供特定语言环境的翻译，这也将作为后备语言环境。
+
+    文件结构示例：
+
+    ```text
+    content/
+    ├── en/
+    │   └── markdown-file.en.content.md
+    ├── fr/
+    │   └── markdown-file.fr.content.md
+    └── es/
+        └── markdown-file.es.content.md
+    ```
+
+    您可以在 front-matter 中添加任何在[字典定义](https://github.com/aymericzip/intlayer/blob/main/docs/docs/zh/dictionary/content_file.md)中定义的属性。
+
+  </Tab>
+  <Tab label="手动包装" value="manual-wrapping">
+    使用 `md` 函数显式声明 Markdown 内容。如果您想确保即使字符串不包含明显的语法也被视为 Markdown，这将非常有用。
 
     ```typescript fileName="markdownDictionary.content.ts"
     import { md, type Dictionary } from "intlayer";
@@ -61,12 +96,12 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
 
   </Tab>
   <Tab label="自动检测" value="automatic-detection">
-    如果字符串包含常见的 Markdown 标记（如标题、列表、链接等），Intlayer 会自动将其转换。
+    如果字符串包含常见的 Markdown 指示符（如标题、列表、链接等），Intlayer 会自动转换它。
 
     ```typescript fileName="markdownDictionary.content.ts"
     export default {
       key: "app",
-      contentAutoTransformation: true, // 启用 Markdown 内容的自动检测 - 可在 intlayer.config.ts 中全局设置
+      contentAutoTransformation: true, // 启用 Markdown 内容的自动检测 - 可以在 intlayer.config.ts 中全局设置
       content: {
         myMarkdownContent: "## 我的标题 \n\nLorem Ipsum",
       },
@@ -74,7 +109,8 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     ```
 
   </Tab>
-  <Tab label="外部文件">
+
+  <Tab label="外部文件" value="external-files">
     使用 `file` 函数直接导入 `.md` 文件。
 
     ```typescript fileName="markdownDictionary.content.ts"
@@ -85,7 +121,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
       content: {
         content: t({
           en: md(file("./myMarkdown.en.md")),
-          fr: md(file("./myMarkdown.fr.md")),
+          zh: md(file("./myMarkdown.zh.md")),
         }),
       },
     };
@@ -96,38 +132,74 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
 
 ---
 
-## 部分：渲染 Markdown
+## 渲染 Markdown
+
+Intlayer 提供两种独立的方式来渲染 Markdown：
+
+1. **通过 `useIntlayer`**
+   — Intlayer 会自动将 `md` 节点转换为框架的原生输出（JSX，VNode，HTML 字符串）。
+   - Frontmatter 被解析并作为 `.metadata` 暴露。您可以在两个级别上覆盖渲染 — 使用 `MarkdownProvider`（或框架等效物）进行全局覆盖，或使用 `.use()` 针对每个节点进行局部覆盖。两者可以结合使用；`.use()` 优先于 `MarkdownProvider`，而 `MarkdownProvider` 优先于默认渲染。
 
-渲染可以由 Intlayer 的内容系统自动处理，也可以使用专用工具手动完成。
+2. **辅助实用程序** — `<MarkdownRenderer />`，`useMarkdownRenderer()` 和 `renderMarkdown()` 是独立的工具，**仅接受原始 Markdown 字符串**。它们独立于 `useIntlayer`，不与它返回的修饰节点一起工作。
 
-### 1. 自动渲染（使用 `useIntlayer`）
+Markdown 渲染支持 **MDX** — 在您的 Markdown 中直接按名称使用任何 JSX/框架组件。
 
-通过 `useIntlayer` 访问内容时，Markdown 节点已准备好渲染。
+### 1. 自动渲染（通过 `useIntlayer`）
 
 <Tabs group="framework">
   <Tab label="React / Next.js" value="react">
-    Markdown 节点可以直接作为 JSX 渲染。
+    Markdown 节点可以直接呈现为 JSX。
 
     ```tsx fileName="App.tsx"
     import { useIntlayer } from "react-intlayer";
+    import { MarkdownProvider } from "react-intlayer/markdown";
 
     const AppContent = () => {
       const { myMarkdownContent } = useIntlayer("app");
+
       return <div>{myMarkdownContent}</div>;
     };
+
+    const App = () => (
+      <MarkdownProvider
+        components={{
+          h1: ({ children }) => <h1 style={{ color: "red" }}>{children}</h1>,
+          MyButton: (props) => <button {...props} />, // MDX 组件
+        }}
+      >
+        <AppContent />
+      </MarkdownProvider>
+    );
     ```
 
-    您还可以使用 `.use()` 方法为特定节点提供局部覆盖：
+    > 如果没有提供 `MarkdownProvider`，Intlayer 将使用默认的 Markdown 转 JSX 解析器渲染 markdown。
+
+    您还可以使用 `.use()` 方法提供特定节点的局部覆盖：
 
     ```tsx
     {myMarkdownContent.use({
-      h1: ({ children }) => <h1 className="text-3xl font-bold">{children}</h1>,
+      h1: ({ children }) => <h1 style={{ color: "red" }}>{children}</h1>,
     })}
     ```
 
+    您可以以字符串形式检索 Markdown：
+
+    ```tsx
+    {myMarkdownContent.value}
+    {String(myMarkdownContent)}
+    {myMarkdownContent.toString()}
+    ```
+
+    您可以像这样访问您的 markdown 元数据：
+
+    ```tsx
+    {myMarkdownContent.metadata}
+    {myMarkdownContent.metadata.title}
+    ```
+
   </Tab>
   <Tab label="Vue" value="vue">
-    在 Vue 中，Markdown 内容可以使用内置的 `component` 渲染，或者直接作为节点渲染。
+    在 Vue 中，Markdown 内容可以使用内置的 `component` 或直接作为节点来呈现。
 
     ```vue fileName="App.vue"
     <script setup>
@@ -140,48 +212,188 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     </template>
     ```
 
+    通过 `intlayerMarkdown` 插件进行全局配置（支持 MDX 自定义组件）：
+
+    ```ts fileName="main.ts"
+    import { intlayerMarkdown } from "vue-intlayer/markdown";
+
+    app.use(intlayerMarkdown, {
+      components: {
+        h1: (props) => h('h1', { style: { color: 'green' } }, props.children),
+        MyButton: (props) => h('button', props), // MDX 组件
+      },
+    });
+    ```
+
+    > 如果未安装 `intlayerMarkdown` 插件，Intlayer 将使用默认编译器进行渲染。
+
+    您还可以使用 `.use()` 方法提供特定节点的局部覆盖：
+
+    ```vue
+    <component :is="myMarkdownContent.use({
+      h1: (props) => h('h1', { style: { color: 'red' } }, props.children),
+    })" />
+    ```
+
+    您可以以字符串形式检索 Markdown：
+
+    ```vue
+    {{ myMarkdownContent.value }}
+    {{ String(myMarkdownContent) }}
+    {{ myMarkdownContent.toString() }}
+    ```
+
+    您可以像这样访问您的 markdown 元数据：
+
+    ```vue
+    <component :is="myMarkdownContent.metadata" />
+    <component :is="myMarkdownContent.metadata.title" />
+    ```
+
   </Tab>
   <Tab label="Svelte" value="svelte">
-    Svelte 默认将 Markdown 渲染为 HTML 字符串。使用 `{@html}` 渲染。
+    默认情况下，Svelte 将 Markdown 呈现为 HTML 字符串。使用 `{@html}` 来渲染它。
 
-    ```svelte
+    ```svelte fileName="App.svelte"
     <script lang="ts">
     import { useIntlayer } from "svelte-intlayer";
+    import { MarkdownProvider } from "svelte-intlayer/markdown";
+    import MyHeading from "./MyHeading.svelte";
+
     const content = useIntlayer("app");
     </script>
 
-    {@html $content.myMarkdownContent}
+    <MarkdownProvider components={{ h1: MyHeading }}>
+      {@html $content.myMarkdownContent}
+    </MarkdownProvider>
+    ```
+
+    > 如果未提供 `MarkdownProvider`，Intlayer 将使用默认编译器渲染 markdown。
+
+    您还可以使用 `.use()` 方法提供特定节点的局部覆盖：
+
+    ```svelte
+    {@html $content.myMarkdownContent.use({ ... })}
+    ```
+
+    您可以以字符串形式检索 Markdown：
+
+    ```svelte
+    {$content.myMarkdownContent.value}
+    {String($content.myMarkdownContent)}
+    {$content.myMarkdownContent.toString()}
+    ```
+
+    您可以像这样访问您的 markdown 元数据：
+
+    ```svelte
+    {$content.myMarkdownContent.metadata}
+    {$content.myMarkdownContent.metadata.title}
     ```
 
   </Tab>
   <Tab label="Preact" value="preact">
-    Preact 在 JSX 中直接支持 Markdown 节点。
+    Preact 直接支持 JSX 中的 Markdown 节点。
 
     ```tsx fileName="App.tsx"
     import { useIntlayer } from "preact-intlayer";
+    import { MarkdownProvider } from "preact-intlayer/markdown";
 
     const AppContent = () => {
       const { myMarkdownContent } = useIntlayer("app");
       return <div>{myMarkdownContent}</div>;
     };
+
+    const App = () => (
+      <MarkdownProvider
+        components={{
+          h1: ({ children }) => <h1 style={{ color: "red" }}>{children}</h1>,
+          MyButton: (props) => <button {...props} />, // MDX 组件
+        }}
+      >
+        <AppContent />
+      </MarkdownProvider>
+    );
+    ```
+
+    > 如果未提供 `MarkdownProvider`，Intlayer 将使用默认的 Markdown 转 JSX 解析器渲染 markdown。
+
+    您还可以使用 `.use()` 方法提供特定节点的局部覆盖：
+
+    ```tsx
+    {myMarkdownContent.use({
+      h1: ({ children }) => <h1 style={{ color: "red" }}>{children}</h1>,
+    })}
+    ```
+
+    您可以以字符串形式检索 Markdown：
+
+    ```tsx
+    {myMarkdownContent.value}
+    {String(myMarkdownContent)}
+    {myMarkdownContent.toString()}
+    ```
+
+    您可以像这样访问您的 markdown 元数据：
+
+    ```tsx
+    {myMarkdownContent.metadata}
+    {myMarkdownContent.metadata.title}
     ```
 
   </Tab>
   <Tab label="Solid" value="solid">
-    Solid 在 JSX 中直接支持 Markdown 节点。
+    Solid 直接支持 JSX 中的 Markdown 节点。
 
     ```tsx fileName="App.tsx"
     import { useIntlayer } from "solid-intlayer";
+    import { MarkdownProvider } from "solid-intlayer/markdown";
 
     const AppContent = () => {
       const { myMarkdownContent } = useIntlayer("app");
       return <div>{myMarkdownContent}</div>;
     };
+
+    const App = () => (
+      <MarkdownProvider
+        components={{
+          h1: (props) => <h1 style={{ color: "red" }}>{props.children}</h1>,
+          MyButton: (props) => <button {...props} />, // MDX 组件
+        }}
+      >
+        <AppContent />
+      </MarkdownProvider>
+    );
+    ```
+
+    > 如果未提供 `MarkdownProvider`，Intlayer 将使用默认的 Markdown 转 JSX 解析器渲染 markdown。
+
+    您还可以使用 `.use()` 方法提供特定节点的局部覆盖：
+
+    ```tsx
+    {myMarkdownContent.use({
+      h1: (props) => <h1 style={{ color: "red" }}>{props.children}</h1>,
+    })}
+    ```
+
+    您可以以字符串形式检索 Markdown：
+
+    ```tsx
+    {myMarkdownContent.value}
+    {String(myMarkdownContent)}
+    {myMarkdownContent.toString()}
+    ```
+
+    您可以像这样访问您的 markdown 元数据：
+
+    ```tsx
+    {myMarkdownContent.metadata}
+    {myMarkdownContent.metadata.title}
     ```
 
   </Tab>
   <Tab label="Angular" value="angular">
-    Angular 使用 `[innerHTML]` 指令来渲染 Markdown 内容。
+    Angular 使用 `[innerHTML]` 指令来呈现 Markdown 内容。
 
     ```typescript fileName="app.component.ts"
     import { Component } from "@angular/core";
@@ -196,7 +408,9 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     }
     ```
 
-    您还可以使用 `.use()` 方法为特定节点提供局部覆盖：
+    > 如果未配置 IntlayerMarkdown 提供程序，Intlayer 将使用默认编译器进行渲染。
+
+    您还可以使用 `.use()` 方法提供特定节点的局部覆盖：
 
     ```typescript
     content().myMarkdownContent.use({
@@ -204,12 +418,27 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     })
     ```
 
+    您可以以字符串形式检索 Markdown：
+
+    ```typescript
+    content().myMarkdownContent.value
+    String(content().myMarkdownContent)
+    content().myMarkdownContent.toString()
+    ```
+
+    您可以像这样访问您的 markdown 元数据：
+
+    ```typescript
+    content().myMarkdownContent.metadata
+    content().myMarkdownContent.metadata.title
+    ```
+
   </Tab>
 </Tabs>
 
-### 2. 手动渲染与高级工具
+### 2. 辅助实用程序（仅限 Markdown 字符串）
 
-如果您需要渲染原始 Markdown 字符串或对渲染过程有更多控制，请使用以下工具。
+这些实用程序渲染 **仅限原始 Markdown 字符串** 且独立于 `useIntlayer`。当您需要从词典以外的来源渲染 Markdown 时使用它们。
 
 <Tabs group="framework">
   <Tab label="React / Next.js" value="react">
@@ -226,7 +455,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     </MarkdownRenderer>
     ```
 
-    #### `useMarkdownRenderer()` Hook
+    #### `useMarkdownRenderer()` 钩子
 
     获取预配置的渲染器函数。
 
@@ -241,8 +470,8 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     return renderMarkdown("# 我的标题");
     ```
 
-    #### `renderMarkdown()` 实用工具
-    用于在组件外渲染的独立实用工具。
+    #### `renderMarkdown()` 实用程序
+    组件外部渲染的独立实用程序。
 
     ```tsx
     import { renderMarkdown } from "react-intlayer/markdown";
@@ -278,7 +507,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     <MarkdownRenderer forceBlock={true} value="# 我的标题" />
     ```
 
-    #### `useMarkdownRenderer()` Hook
+    #### `useMarkdownRenderer()` 钩子
 
     ```svelte
     <script lang="ts">
@@ -289,7 +518,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     {@html render("# 我的标题")}
     ```
 
-    #### `renderMarkdown()` 实用工具
+    #### `renderMarkdown()` 实用程序
 
     ```svelte
     <script lang="ts">
@@ -311,7 +540,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     </MarkdownRenderer>
     ```
 
-    #### `useMarkdownRenderer()` Hook
+    #### `useMarkdownRenderer()` 钩子
 
     ```tsx
     import { useMarkdownRenderer } from "preact-intlayer/markdown";
@@ -321,7 +550,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     return <div>{render("# 我的标题")}</div>;
     ```
 
-    #### `renderMarkdown()` 实用工具
+    #### `renderMarkdown()` 实用程序
 
     ```tsx
     import { renderMarkdown } from "preact-intlayer/markdown";
@@ -341,7 +570,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     </MarkdownRenderer>
     ```
 
-    #### `useMarkdownRenderer()` Hook
+    #### `useMarkdownRenderer()` 钩子
 
     ```tsx
     import { useMarkdownRenderer } from "solid-intlayer/markdown";
@@ -351,7 +580,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     return <div>{render("# 我的标题")}</div>;
     ```
 
-    #### `renderMarkdown()` 实用工具
+    #### `renderMarkdown()` 实用程序
 
     ```tsx
     import { renderMarkdown } from "solid-intlayer/markdown";
@@ -362,7 +591,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
   </Tab>
   <Tab label="Angular" value="angular">
     #### `IntlayerMarkdownService` 服务
-    使用该服务渲染 Markdown 字符串。
+    使用服务呈现 Markdown 字符串。
 
     ```typescript
     import { IntlayerMarkdownService } from "angular-intlayer/markdown";
@@ -381,9 +610,9 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
 
 ---
 
-## 使用 `MarkdownProvider` 的全局配置
+## 使用 `MarkdownProvider` 进行全局配置
 
-您可以为整个应用程序全局配置 Markdown 渲染。这可以避免为每个渲染器传递相同的 props。
+`MarkdownProvider`（或其框架对应的组件）为整个应用程序配置 Markdown 渲染管道。它适用于自动 `useIntlayer` 渲染和辅助实用程序。此处设置的选项为默认值 — `.use()` 在节点级别将其覆盖。
 
 <Tabs group="framework">
   <Tab label="React / Next.js" value="react">
@@ -394,8 +623,9 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     export const AppProvider = ({ children }) => (
       <MarkdownProvider
         components={{
-          h1: ({ children }) => <h1 className="text-2xl font-bold">{children}</h1>,
-          a: ({ href, children }) => <Link to={href}>{children}</Link>,
+          h1: (props) => <h1 style={{color: 'green'}} {...props} />,
+          a: ({ href, ...props }) => <a style={{color: 'red'}} {...props} />,
+          MyCustomJSXComponent: (props) => <span style={{color: 'red'}} {...props} />,
         }}
       >
         {children}
@@ -403,7 +633,9 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     );
     ```
 
-    您也可以使用自己的 Markdown 渲染器：
+    > 支持 MDX — Markdown 内部使用的任何组件名称（例如 `<MyCustomJSXComponent />`）都会根据 `components` 映射进行解析。
+
+    您还可以使用自己的 markdown 渲染器：
 
     ```tsx fileName="AppProvider.tsx"
     import { MarkdownProvider } from "react-intlayer/markdown";
@@ -411,8 +643,8 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     export const AppProvider = ({ children }) => (
       <MarkdownProvider
         renderMarkdown={async (md) => {
-          const { compileMarkdown } = await import('react-intlayer/markdown');
-          return compileMarkdown(md);
+          const { renderMarkdown } = await import('react-intlayer/markdown');
+          return renderMarkdown(md);
         }}
       >
         {children}
@@ -420,7 +652,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     );
     ```
 
-    > 动态导入 Markdown 渲染器是减小应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
 
   </Tab>
   <Tab label="Vue" value="vue">
@@ -437,7 +669,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     app.use(intlayerMarkdown, {
       components: {
         h1: (props) =>
-          h('h1', { style: { color: 'orange' }, ...props }, props.children),
+        h('h1', { style: { color: 'orange' }, ...props }, props.children),
         ComponentDemo: () => h('div', { style: { background: 'grey' } }, 'DEMO'),
         bold: (props) => h('strong', props),
         code: (props) => h('code', props),
@@ -447,7 +679,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     app.mount("#app");
     ```
 
-    您也可以使用自己的 Markdown 渲染器：
+    您还可以使用自己的 markdown 渲染器：
 
     ```typescript fileName="main.ts"
     import { createApp } from "vue";
@@ -460,15 +692,15 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     app.use(intlayer);
     app.use(intlayerMarkdown, {
       renderMarkdown: async (md) => {
-        const { compileMarkdown } = await import('vue-intlayer/markdown');
-        return compileMarkdown(md);
+        const { renderMarkdown } = await import('vue-intlayer/markdown');
+        return renderMarkdown(md);
       },
     });
 
     app.mount("#app");
     ```
 
-    > 动态导入 Markdown 渲染器是减小应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
 
   </Tab>
   <Tab label="Svelte" value="svelte">
@@ -488,7 +720,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     </MarkdownProvider>
     ```
 
-    您也可以使用自己的 Markdown 渲染器：
+    您还可以使用自己的 markdown 渲染器：
 
     ```svelte fileName="App.svelte"
     <script lang="ts">
@@ -497,15 +729,15 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
 
     <MarkdownProvider
       renderMarkdown={async (md) => {
-        const { compileMarkdown } = await import('svelte-intlayer/markdown');
-        return compileMarkdown(md);
+        const { renderMarkdown } = await import('svelte-intlayer/markdown');
+        return renderMarkdown(md);
       }}
     >
       <slot />
     </MarkdownProvider>
     ```
 
-    > 动态导入 Markdown 渲染器是减小应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
 
   </Tab>
   <Tab label="Preact" value="preact">
@@ -524,7 +756,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     );
     ```
 
-    您也可以使用自己的 Markdown 渲染器：
+    您还可以使用自己的 markdown 渲染器：
 
     ```tsx fileName="AppProvider.tsx"
     import { MarkdownProvider } from "preact-intlayer/markdown";
@@ -532,8 +764,8 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     export const AppProvider = ({ children }) => (
       <MarkdownProvider
         renderMarkdown={async (md) => {
-          const { compileMarkdown } = await import('preact-intlayer/markdown');
-          return compileMarkdown(md);
+          const { renderMarkdown } = await import('preact-intlayer/markdown');
+          return renderMarkdown(md);
         }}
       >
         {children}
@@ -541,7 +773,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     );
     ```
 
-    > 动态导入 Markdown 渲染器是减小应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
 
   </Tab>
   <Tab label="Solid" value="solid">
@@ -560,7 +792,7 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     );
     ```
 
-    您也可以使用自己的 Markdown 渲染器：
+    您还可以使用自己的 markdown 渲染器：
 
     ```tsx fileName="AppProvider.tsx"
     import { MarkdownProvider } from "solid-intlayer/markdown";
@@ -568,8 +800,8 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     export const AppProvider = (props) => (
       <MarkdownProvider
         renderMarkdown={async (md) => {
-          const { compileMarkdown } = await import('solid-intlayer/markdown');
-          return compileMarkdown(md);
+          const { renderMarkdown } = await import('solid-intlayer/markdown');
+          return renderMarkdown(md);
         }}
       >
         {props.children}
@@ -577,59 +809,29 @@ Intlayer 支持使用 Markdown 语法定义的富文本内容。这允许您轻
     );
     ```
 
-    > 动态导入 Markdown 渲染器是减小应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
 
   </Tab>
   <Tab label="Angular" value="angular">
 
-    ```typescript fileName="app.config.ts"
-    import { createIntlayerMarkdownProvider } from "angular-intlayer/markdown";
-
-    export const appConfig: ApplicationConfig = {
-      providers: [
-        createIntlayerMarkdownProvider({
-          components: {
-            h1: { class: "text-2xl font-bold" },
-          },
-        }),
-      ],
-    };
-    ```
-
-    您也可以使用自己的 Markdown 渲染器：
-
-    ```typescript fileName="app.config.ts"
-    import { createIntlayerMarkdownProvider } from "angular-intlayer/markdown";
+    ```typescript fileName="app.module.ts"
+    import { NgModule } from '@angular/core';
+    import { IntlayerMarkdownModule } from 'angular-intlayer/markdown';
 
-    export const appConfig: ApplicationConfig = {
-      providers: [
-        createIntlayerMarkdownProvider({
+    @NgModule({
+      imports: [
+        IntlayerMarkdownModule.forRoot({
           renderMarkdown: async (md) => {
-            const { compileMarkdown } = await import('angular-intlayer/markdown');
-            return compileMarkdown(md);
-          },
-        }),
-      ],
-    };
+            const { renderMarkdown } = await import('angular-intlayer/markdown');
+            return renderMarkdown(md);
+          }
+        })
+      ]
+    })
+    export class AppModule {}
     ```
 
-    > 动态导入 Markdown 渲染器是减小应用程序包大小的好方法。
+    > 动态导入您的 Markdown 渲染器是减少应用程序包大小的好方法。
 
   </Tab>
 </Tabs>
-
----
-
-## 选项参考
-
-这些选项可以传递给 `MarkdownProvider`、`MarkdownRenderer`、`useMarkdownRenderer` 和 `renderMarkdown`。
-
-| 选项                  | 类型        | 默认    | 说明                                                            |
-| :-------------------- | :---------- | :------ | :-------------------------------------------------------------- |
-| `forceBlock`          | `boolean`   | `false` | 强制将输出包裹在块级元素中（例如 `<div>`）。                    |
-| `forceInline`         | `boolean`   | `false` | 强制将输出包裹在内联元素中（例如 `<span>`）。                   |
-| `tagfilter`           | `boolean`   | `true`  | 启用 GitHub 标签过滤器，通过剥离危险的 HTML 标签来提高安全性。  |
-| `preserveFrontmatter` | `boolean`   | `false` | 如果为 `true`，Markdown 字符串开头的 frontmatter 将不会被剥离。 |
-| `components`          | `Overrides` | `{}`    | HTML 标签到自定义组件的映射（例如 `{ h1: MyHeading }`）。       |
-| `wrapper`             | `Component` | `null`  | 用于包裹渲染后的 Markdown 的自定义组件。                        |
-| `renderMarkdown`      | `Function`  | `null`  | 一个自定义渲染函数，用于完全替换默认的 Markdown 编译器。        |