}>{markdownContent}\n );\n};\n```\n\n \n \n\nAngular không có Suspense API. Sử dụng chế độ xem có thể trì hoãn (`@defer`) của Angular để xử lý nội dung Markdown được tải chậm (yêu cầu Angular 17+).\n\n```typescript fileName=\"my.component.ts\"\nimport { Component } from \"@angular/core\";\nimport { useIntlayer } from \"angular-intlayer\";\n\n@Component({\n selector: \"app-my\",\n template: `\n @defer {\n
    \n } @loading {\n
    Loading...
    \n }\n `,\n})\nexport class MyComponent {\n content = useIntlayer(\"my-markdown\");\n}\n```\n\n
    \n\n\n---\n\n## Render Phía Server (SSR) và Hydrat Hóa\n\nSo với các trình phân tích cú pháp Markdown khác như remark / rehype, Intlayer Markdown không phụ thuộc và chạy trên cả client lẫn server.\n\nNhưng Intlayer tối ưu hóa việc phân tích cú pháp cho các framework Server-Side Rendering (SSR) (như Next.js App Router, React Router, Nuxt, SvelteKit, v.v.).\n\nThay vì gửi chuỗi Markdown thô đến client và phân tích cú pháp trên trình duyệt (gây giảm hiệu suất), Intlayer cho phép bạn phân tích cú pháp trước Markdown thành Cây Cú Pháp Trừu Tượng (AST) trên server.\n\nBạn có thể sử dụng hàm `parseMarkdown` từ gói Intlayer của framework phía server để tạo ra một AST có thể tuần tự hóa (đối tượng `ParsedMarkdown`), và chuyển trực tiếp đến frontend. Tất cả các tiện ích render của Intlayer (như ``, `useMarkdownRenderer`, v.v.) tự động chấp nhận đối tượng AST này và hiển thị nó một cách liền mạch.\n\n### Ví dụ trong Kiến Trúc Server/Client\n\n\n \n\n ```tsx fileName=\"server.ts\"\n import { parseMarkdown } from \"react-intlayer/markdown\";\n\n // 1. Trên server: Phân tích cú pháp markdown thành AST có thể tuần tự hóa\n export const loader = async () => {\n const markdownString = \"## My title \\n\\nLorem Ipsum\";\n const ast = parseMarkdown(markdownString);\n\n // Trả về AST dưới dạng JSON cho client\n return Response.json({ content: ast });\n };\n ```\n\n ```tsx fileName=\"client.tsx\"\n import { useLoaderData } from \"react-router\";\n import { MarkdownRenderer } from \"react-intlayer/markdown\";\n\n // 2. Trên client: Hiển thị trực tiếp AST mà không cần phân tích cú pháp lại\n export default function Page() {\n const { content } = useLoaderData();\n\n // Trình kết xuất chấp nhận chuỗi thô hoặc AST đã được phân tích cú pháp\n return ;\n }\n ```\n\n \n \n\n ```tsx fileName=\"app/page.tsx\"\n import { parseMarkdown } from \"next-intlayer/markdown\";\n import { MarkdownRenderer } from \"next-intlayer/markdown\";\n\n export default async function Page() {\n // 1. Phân tích cú pháp markdown thành AST có thể tuần tự hóa trên server\n const markdownString = \"## My title \\n\\nLorem Ipsum\";\n const ast = parseMarkdown(markdownString);\n\n // 2. Hiển thị trực tiếp AST\n // Trong một Server Component, hoạt động này diễn ra liền mạch và chuyển AST\n // trực tiếp đến các client component bên dưới nếu cần.\n return ;\n }\n ```\n\n \n \n\n ```vue fileName=\"pages/index.vue\"\n \n\n \n ```\n\n \n \n\n ```typescript fileName=\"+page.server.ts\"\n import { parseMarkdown } from \"svelte-intlayer/markdown\";\n\n // 1. Trên server: Phân tích cú pháp markdown thành AST có thể tuần tự hóa\n export const load = async () => {\n const markdownString = \"## My title \\n\\nLorem Ipsum\";\n const ast = parseMarkdown(markdownString);\n\n // Trả về AST cho client\n return { content: ast };\n };\n ```\n\n ```svelte fileName=\"+page.svelte\"\n \n\n \n \n ```\n\n \n \n\n Angular SSR thường giải quyết dữ liệu trên server trong lần tải đầu tiên và hydrat hóa trên client. Bạn có thể sử dụng resolver để truyền AST.\n\n ```typescript fileName=\"app.resolver.ts\"\n import { Injectable } from \"@angular/core\";\n import { Resolve } from \"@angular/router\";\n import { parseMarkdown, type ParsedMarkdown } from \"angular-intlayer/markdown\";\n\n @Injectable({ providedIn: \"root\" })\n export class MarkdownResolver implements Resolve {\n resolve(): ParsedMarkdown {\n const markdownString = \"## My title \\n\\nLorem Ipsum\";\n // 1. Trên server: Phân tích cú pháp markdown thành AST có thể tuần tự hóa\n return parseMarkdown(markdownString);\n }\n }\n ```\n\n ```typescript fileName=\"app.component.ts\"\n import { Component } from \"@angular/core\";\n import { ActivatedRoute } from \"@angular/router\";\n import { IntlayerMarkdownService, type ParsedMarkdown } from \"angular-intlayer/markdown\";\n\n @Component({\n selector: \"app-root\",\n template: `
    `,\n })\n export class AppComponent {\n renderedMarkdown: string = \"\";\n\n constructor(\n private route: ActivatedRoute,\n private markdownService: IntlayerMarkdownService\n ) {\n // 2. Trên client: Hiển thị trực tiếp AST mà không cần phân tích cú pháp lại\n this.route.data.subscribe((data) => {\n this.renderedMarkdown = this.markdownService.renderMarkdown(\n data.markdownAst\n ) as string;\n });\n }\n }\n ```\n\n
    \n
    \n\nMẫu này đảm bảo logic phân tích cú pháp Markdown được thực thi hoàn toàn trên server, giảm đáng kể thời gian thực thi phía client và cải thiện tốc độ hydrat hóa ban đầu.\n\n## Tham chiếu tùy chọn\n\nCác tùy chọn này có thể được truyền đến `MarkdownProvider`, `MarkdownRenderer`, `useMarkdownRenderer` và `renderMarkdown`.\n\n| Option | Type | Default | Mô tả |\n| :-------------------- | :---------- | :------ | :------------------------------------------------------------------------------------ |\n| `forceBlock` | `boolean` | `false` | Bắt buộc đầu ra phải được bọc trong một phần tử cấp khối (ví dụ: `
    `). |\n| `forceInline` | `boolean` | `false` | Bắt buộc đầu ra phải được bọc trong một phần tử nội tuyến (ví dụ: ``). |\n| `tagfilter` | `boolean` | `true` | Bật Bộ lọc thẻ GitHub để cải thiện bảo mật bằng cách loại bỏ các thẻ HTML nguy hiểm. |\n| `preserveFrontmatter` | `boolean` | `false` | Nếu `true`, frontmatter ở đầu chuỗi Markdown sẽ không bị tước đi. |\n| `components` | `Overrides` | `{}` | Bản đồ các thẻ HTML cho các thành phần tùy chỉnh (ví dụ: `{ h1: MyHeading }`). |\n| `wrapper` | `Component` | `null` | Thành phần tùy chỉnh để bọc Markdown đã kết xuất. |\n| `renderMarkdown` | `Function` | `null` | Chức năng kết xuất tùy chỉnh để thay thế hoàn toàn trình biên dịch Markdown mặc định. |\n","about":"Tìm hiểu cách khai báo và sử dụng nội dung Markdown trong trang web đa ngôn ngữ của bạn với Intlayer. Làm theo các bước trong tài liệu trực tuyến này để tích hợp Markdown một cách liền mạch vào dự án của bạn.","url":"https://intlayer.org/vi/doc/concept/content/markdown","datePublished":"07-02-2025","dateModified":"19-05-2026","keywords":"Markdown, Quốc tế hóa, Tài liệu, Intlayer, Next.js, JavaScript, React","license":"https://raw.githubusercontent.com/aymericzip/intlayer/refs/heads/main/LICENSE","audience":{"@type":"Audience","audienceType":"Nhà phát triển (Developers), Quản trị nội dung (Content Managers)"}}
    Ngày tạo:2025-02-07Cập nhật lần cuối:2026-05-19

    Markdown / Nội dung Rich Text

    Intlayer hỗ trợ nội dung rich text được định nghĩa bằng cú pháp Markdown. Điều này cho phép bạn dễ dàng viết và duy trì nội dung được định dạng phong phú như blog, bài viết, và hơn thế nữa.

    Khai báo Nội dung Markdown

    Bạn có thể khai báo nội dung Markdown bằng cách sử dụng hàm md hoặc đơn giản là một chuỗi (nếu nó chứa cú pháp Markdown).

    Bắt đầu từ phiên bản 8.10.0, bạn có thể khai báo nội dung Markdown trực tiếp trong các tệp .content.md. Intlayer sẽ tự động phát hiện và phân tích nội dung Markdown.

    markdown-file.en.content.md
    ---key: my-markdown-contentdescription: Nội dung của tôilocale: en---# Nội dung của tôiDưới đây là một ví dụ về nội dung markdown

    Trường front-matter locale là trường xác định ngôn ngữ của nội dung. Nó là tùy chọn. Nếu không được cung cấp, Intlayer sẽ sử dụng ngôn ngữ mặc định, ngôn ngữ này cũng được sử dụng làm ngôn ngữ dự phòng nếu không có bản dịch cho một ngôn ngữ cụ thể.

    Ví dụ về cấu trúc tệp:

    text
    content├── markdown-file.en.content.md├── markdown-file.fr.content.md└── markdown-file.es.content.md

    Bạn có thể thêm vào front-matter bất kỳ thuộc tính nào được định nghĩa trong Định nghĩa Từ điển

    Render Markdown

    Intlayer cung cấp hai cách độc lập để render Markdown:

    1. Thông qua useIntlayer — Intlayer tự động chuyển đổi node md thành đầu ra nguyên bản của framework (JSX, VNode, chuỗi HTML).

      • Frontmatter được phân tích cú pháp và hiển thị dưới dạng .metadata. Bạn có thể ghi đè quá trình render ở hai cấp độ — toàn cục với MarkdownProvider (hoặc tương đương trong framework) và cục bộ trên mỗi node bằng .use(). Cả hai đều có thể được kết hợp; .use() được ưu tiên hơn MarkdownProvider, và MarkdownProvider được ưu tiên hơn mặc định.
    2. Các tiện ích hỗ trợ<MarkdownRenderer />, useMarkdownRenderer(), và renderMarkdown() là các công cụ độc lập chấp nhận chỉ các chuỗi Markdown thô. Chúng độc lập với useIntlayer và không hoạt động với các node được trang trí mà nó trả về.

    Render Markdown hỗ trợ MDX — sử dụng bất kỳ component JSX/framework nào bằng tên trực tiếp bên trong Markdown của bạn.

    1. Render Tự động (thông qua useIntlayer)

    Các node Markdown có thể được render trực tiếp dưới dạng JSX.

    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} />, // Component MDX    }}  >    <AppContent />  </MarkdownProvider>);
    Nếu không có MarkdownProvider, Intlayer sẽ render markdown bằng cách sử dụng trình phân tích cú pháp Markdown sang JSX mặc định.

    Bạn cũng có thể cung cấp các ghi đè cục bộ cho các node cụ thể bằng phương thức .use():

    tsx
    {myMarkdownContent.use({  h1: ({ children }) => <h1 style={{ color: "red" }}>{children}</h1>,})}

    Bạn có thể lấy Markdown dưới dạng chuỗi:

    tsx
    {myMarkdownContent.value}{String(myMarkdownContent)}{myMarkdownContent.toString()}

    Và bạn có thể truy cập siêu dữ liệu markdown của mình như sau:

    tsx
    {myMarkdownContent.metadata}{myMarkdownContent.metadata.title}

    2. Các tiện ích hỗ trợ (Chỉ Chuỗi Markdown)

    Các tiện ích này chỉ render các chuỗi Markdown thô và độc lập với useIntlayer. Hãy sử dụng chúng khi bạn cần render Markdown từ các nguồn khác ngoài từ điển của bạn.

    Component <MarkdownRenderer />

    Render một chuỗi Markdown với các tùy chọn cụ thể.

    tsx
    import { MarkdownRenderer } from "react-intlayer/markdown";<MarkdownRenderer forceBlock={true} tagfilter={true}>  {"# Tiêu đề của tôi"}</MarkdownRenderer>

    Hook useMarkdownRenderer()

    Nhận một hàm render đã được cấu hình trước.

    tsx
    import { useMarkdownRenderer } from "react-intlayer/markdown";const renderMarkdown = useMarkdownRenderer({  forceBlock: true,  components: { h1: (props) => <h1 {...props} className="custom" /> }});return renderMarkdown("# Tiêu đề của tôi");

    Tiện ích renderMarkdown()

    Tiện ích độc lập để render bên ngoài các component.

    tsx
    import { renderMarkdown } from "react-intlayer/markdown";const jsx = renderMarkdown("# Tiêu đề của tôi", { forceBlock: true });

    Cấu hình Toàn cục với MarkdownProvider

    MarkdownProvider (hoặc tương đương trong framework) cấu hình pipeline render Markdown cho toàn bộ ứng dụng của bạn. Điều này áp dụng cho cả render useIntlayer tự động và các tiện ích hỗ trợ. Các tùy chọn được đặt ở đây là mặc định — .use() sẽ ghi đè chúng ở cấp độ node.

    AppProvider.tsx
    import { MarkdownProvider } from "react-intlayer/markdown";export const AppProvider = ({ children }) => (  <MarkdownProvider    components={{      h1: (props) => <h1 style={{color: 'green'}} {...props} />,      a: ({ href, ...props }) => <a style={{color: 'red'}} {...props} />,      MyCustomJSXComponent: (props) => <span style={{color: 'red'}} {...props} />,    }}  >    {children}  </MarkdownProvider>);
    Hỗ trợ MDX — bất kỳ tên component nào được sử dụng bên trong Markdown của bạn (ví dụ: <MyCustomJSXComponent />) đều được phân giải dựa trên bản đồ components.

    Bạn cũng có thể sử dụng trình render markdown của riêng mình:

    AppProvider.tsx
    import { MarkdownProvider } from "react-intlayer/markdown";export const AppProvider = ({ children }) => (  <MarkdownProvider    renderMarkdown={async (md) => {      // Use dynamic import to reduce the bundle size of your application      const { renderMarkdown } = await import('react-intlayer/markdown');      return renderMarkdown(md);    }}  >    {children}  </MarkdownProvider>);
    Việc nhập trình render Markdown của bạn một cách động là một cách tuyệt vời để giảm dung lượng bundle của ứng dụng.

    Suspense

    Trình kết xuất Markdown của Intlayer được tải động. Mặc dù được tối ưu hóa, đoạn phân tích cú pháp cơ bản là khoảng 55kb. Tải điều này đồng bộ sẽ trì hoãn kết xuất trang ban đầu và làm suy giảm First Contentful Paint (FCP).

    Để ngăn chặn việc chặn giao diện người dùng, Intlayer tích hợp với Suspense API của React. Nó tìm nạp trình phân tích cú pháp trong nền và ném Promise trong khi tải xuống.

    Bọc bất kỳ thành phần nào kết xuất Intlayer Markdown trong ranh giới <Suspense>. Điều này hiển thị trạng thái dự phòng được bản địa hóa trong khi đoạn phim tải xuống, cho phép phần còn lại của DOM của bạn kết xuất ngay lập tức.

    Cảnh báo: Nếu bạn không cung cấp ranh giới <Suspense>, React sẽ đình chỉ ở cấp gốc hoặc chặn toàn bộ cây thành phần khỏi kết xuất cho đến khi đoạn 55kb được tải hoàn toàn.

    Trong Next.js App Router, bạn có thể sử dụng React Suspense cho các thành phần máy khách hoặc tệp loading.tsx cho các thành phần máy chủ.

    Thành phần máy khách:

    components/MyComponent.tsx
    "use client";import { useIntlayer } from "next-intlayer";import { Suspense } from "react";const MyComponent = () => {const markdownContent = useIntlayer("my-markdown");return (  <Suspense fallback={<div>Loading...</div>}>{markdownContent}</Suspense>);};

    Thành phần máy chủ với loading.tsx:

    app/loading.tsx
    export default function Loading() {return <div>Loading...</div>;}
    app/page.tsx
    import { useIntlayer } from "next-intlayer/server";const MyPage = () => {const markdownContent = useIntlayer("my-markdown");return <div>{markdownContent}</div>;};export default MyPage;

    Render Phía Server (SSR) và Hydrat Hóa

    So với các trình phân tích cú pháp Markdown khác như remark / rehype, Intlayer Markdown không phụ thuộc và chạy trên cả client lẫn server.

    Nhưng Intlayer tối ưu hóa việc phân tích cú pháp cho các framework Server-Side Rendering (SSR) (như Next.js App Router, React Router, Nuxt, SvelteKit, v.v.).

    Thay vì gửi chuỗi Markdown thô đến client và phân tích cú pháp trên trình duyệt (gây giảm hiệu suất), Intlayer cho phép bạn phân tích cú pháp trước Markdown thành Cây Cú Pháp Trừu Tượng (AST) trên server.

    Bạn có thể sử dụng hàm parseMarkdown từ gói Intlayer của framework phía server để tạo ra một AST có thể tuần tự hóa (đối tượng ParsedMarkdown), và chuyển trực tiếp đến frontend. Tất cả các tiện ích render của Intlayer (như <MarkdownRenderer>, useMarkdownRenderer, v.v.) tự động chấp nhận đối tượng AST này và hiển thị nó một cách liền mạch.

    Ví dụ trong Kiến Trúc Server/Client

    server.ts
    import { parseMarkdown } from "react-intlayer/markdown";// 1. Trên server: Phân tích cú pháp markdown thành AST có thể tuần tự hóaexport const loader = async () => {  const markdownString = "## My title \n\nLorem Ipsum";  const ast = parseMarkdown(markdownString);  // Trả về AST dưới dạng JSON cho client  return Response.json({ content: ast });};
    client.tsx
    import { useLoaderData } from "react-router";import { MarkdownRenderer } from "react-intlayer/markdown";// 2. Trên client: Hiển thị trực tiếp AST mà không cần phân tích cú pháp lạiexport default function Page() {  const { content } = useLoaderData();  // Trình kết xuất chấp nhận chuỗi thô hoặc AST đã được phân tích cú pháp  return <MarkdownRenderer content={content} />;}

    Mẫu này đảm bảo logic phân tích cú pháp Markdown được thực thi hoàn toàn trên server, giảm đáng kể thời gian thực thi phía client và cải thiện tốc độ hydrat hóa ban đầu.

    Tham chiếu tùy chọn

    Các tùy chọn này có thể được truyền đến MarkdownProvider, MarkdownRenderer, useMarkdownRendererrenderMarkdown.

    Option Type Default Mô tả
    forceBlock boolean false Bắt buộc đầu ra phải được bọc trong một phần tử cấp khối (ví dụ: <div>).
    forceInline boolean false Bắt buộc đầu ra phải được bọc trong một phần tử nội tuyến (ví dụ: <span>).
    tagfilter boolean true Bật Bộ lọc thẻ GitHub để cải thiện bảo mật bằng cách loại bỏ các thẻ HTML nguy hiểm.
    preserveFrontmatter boolean false Nếu true, frontmatter ở đầu chuỗi Markdown sẽ không bị tước đi.
    components Overrides {} Bản đồ các thẻ HTML cho các thành phần tùy chỉnh (ví dụ: { h1: MyHeading }).
    wrapper Component null Thành phần tùy chỉnh để bọc Markdown đã kết xuất.
    renderMarkdown Function null Chức năng kết xuất tùy chỉnh để thay thế hoàn toàn trình biên dịch Markdown mặc định.