MDX 파일¶

Added in version 2026.5.

참고

이 형식에 대한 지원은 개발 중입니다. 일부 기능은 아직 사용할 수 없으며 동작이 릴리스 간에 변경될 수 있습니다. 테스트 피드백을 환영합니다.

MDX 파일은 JSX 문법이 포함된 Markdown 파일입니다. Weblate는 번역 가능한 Markdown 텍스트를 추출하고 import, export, JSX 구성요소, 표현식을 보존합니다.

MDX units automatically get the md-text, auto-safe-html, strict-same and safe-mdx flags. This keeps the unsafe HTML check active for plain text, standard HTML, and custom elements while avoiding HTML cleanup on MDX and JSX-like syntax. Use the explicit safe-html flag for strings that are known to contain HTML and should always be sanitized, including SVG or MathML snippets.

참고

대부분의 다른 형식과 달리, 번역 파일의 변경 사항은 안정적으로 가져올 수 없으므로 Weblate로 가져오지 않습니다. 번역의 기준 소스는 번역 파일이 아닌 Weblate입니다.

MDX

파일 예시:

---
title: Ahoj světe!
description: Learn with Weblate
---

import LessonCard from "./LessonCard"
export const metadata = { slug: "intro" }

# Ahoj světe!

<LessonCard title="Keep this code" count={5}>
  Do not translate this JSX body.
</LessonCard>

Orangutan has five bananas.

Try Weblate at [weblate.org](https://demo.weblate.org/)!

*Thank you for using Weblate.*

지원 기능¶
파일 확장자	`.mdx`
언어성 ⓘ	단일 언어
복수형 지원 ⓘ	`No`
설명 지원 ⓘ	`No`
설명 지원 ⓘ	`No`
문맥 지원 ⓘ	`No`
위치 지원 ⓘ	`No`
플래그 지원 ⓘ	`No`
API 식별자	`mdx`
읽기 전용 문자열 지원 ⓘ	`No`
Supports removing obsolete strings ⓘ	`No`
이 형식이 추가하는 검사 플래그 ⓘ	`auto-safe-html`, `strict-same`, `md-text`, Safe MDX

Weblate 구성¶

일반적인 Weblate 구성요소 설정
파일 마스크	`path/*.mdx`
단일언어 기반 언어 파일	`path/en.mdx`
신규 번역의 템플릿	`path/en.mdx`
파일 형식	MDX 파일
파일 형식 매개변수	`mdx_merge_duplicates=True`

중복 문자열 처리¶

기본적으로 Weblate는 줄 기반 컨텍스트를 제공하기 위해 문자열의 각 출현을 별도의 번역 단위로 처리합니다. 이는 MDX 테이블이나 반복되는 구성요소 콘텐츠에서 문제가 될 수 있으며, 순서를 바꾸면 컨텍스트가 달라져 번역 손실로 이어질 수 있습니다.

동일한 문자열을 단일 번역 단위로 통합하려면 파일 형식 매개변수 에서 중복 문자열 제거 를 활성화하세요.

참고

이 옵션을 활성화하면 병합된 단위의 줄 기반 컨텍스트가 비활성화되어 문서 내에서 행이나 섹션이 이동하더라도 번역이 안정적으로 유지됩니다.