파일 가져오기 설정

.MD / .MDX - Markdown 및 MDX (TMS)

컨텐츠는 영어 텍스트를 Phrase Language AI를 이용해 기계 번역한 것입니다.

파일 유형

  • .MD

  • .MARKDOWN

  • .MDX

가져오기 옵션

  • 필터 

    파일을 가져올 때 파서가 사용할 Markdown 방언을 선택하십시오. 이는 가져오기 및 내보내기 시 자동으로 이스케이프/이스케이프 해제되는 문자에도 영향을 미칩니다.

    • 일반

      기본 Markdown 구조(제목, 단락, 목록, 기본 강조)만 구문 분석합니다.

    • PHP/Python Markdown Extra

      PHP Markdown Extra / Python-Markdown "Extra" 방언을 사용하여 구문 분석하며, 표, 정의 목록, 각주, 약어 및 속성 목록에 대한 지원을 추가합니다.

    • GitHub Flavored Markdown

      GitHub Flavored Markdown(GFM) 사양을 사용하여 구문 분석하며, 표, 작업 목록, 취소선 및 자동 링크에 대한 지원을 추가합니다.

    • MDX

      파일을 MDX로 구문 분석합니다: Markdown에 JSX 컴포넌트, JSX 표현식({...}), ESM import/export 문을 더한 형식입니다. 표, 작업 목록, 취소선, 자동 링크는 GitHub Flavored Markdown과 동일하게 작동합니다. MDX는 들여쓰기를 사용하여 컴포넌트를 중첩하고 해당 구문을 구문 분석하지 않으므로, 들여쓰기된 코드 블록과 꺾쇠괄호 자동 링크(<url>)는 지원되지 않습니다.

      MDX는 JSX로 확장된 Markdown이므로 콘텐츠에 컴포넌트와 JavaScript 표현식을 포함할 수 있습니다(예: Docusaurus 또는 Next.js로 빌드된 문서). MDX 필터는 자동으로 선택되지 않습니다. .MDX 파일과 MDX 구문이 포함된 .MD 파일 모두에 대해 파일 가져오기 설정에서 선택해야 합니다. 파일 확장자나 콘텐츠를 기준으로 자동 감지하지 않습니다.

      참고

      조직에 MDX 지원이 활성화되어 있어야 합니다. 필터 목록에서 MDX를 사용할 수 없는 경우, 고객 성공 관리자(Customer Success Manager) 또는 Phrase 지원팀에 문의하십시오.

      중요 사항

      기존 프로젝트의 Markdown 필터를 MDX로 전환하면 콘텐츠가 분할되는 방식이 변경됩니다. 전환 후 번역 메모리 활용도가 한 차례 감소할 것으로 예상됩니다.

  • 하드 줄 바꿈은 새로운 세그먼트를 생성함 

    각 하드 줄 바꿈에서 새 세그먼트를 시작합니다.

  • 공백 보존 

    대상 문서에서 동일한 공백 구조(예: 간격, 줄 바꿈 등)를 유지합니다.

  • YAML 헤더 처리 

    파일 상단의 YAML 프런트 매터를 처리합니다. 선택 시 .YAML 가져오기 설정이 적용됩니다.

  • 코드 블록 가져오기 

    번역을 위해 코드 블록의 내용을 추출합니다. MDX 필터를 사용하면 이는 JSX 컴포넌트 내부에 중첩된 펜스 코드 블록에도 적용됩니다(예: <CodeGroup> 내부).

  • 코드 요소 제외 

    이 옵션을 선택하면 코드 요소를 단일 Phrase TMS 태그로 가져옵니다.

  • URL을 번역 가능하게 설정

    URL을 번역할 수 있도록 설정합니다.

  • Phrase TMS 태그로 변환 

    지정된 텍스트를 태그로 변환하려면 정규식을 적용하십시오.

    중요 사항

    태그 관련 문제는 내보내기 오류의 흔한 원인입니다. 파일을 내보내기 전에 품질 보증 검사를 실행하여 태그와 서식이 올바른지 항상 확인하십시오.

  • 사용자 지정 요소(Phrase 태그로 변환됨) 

    태그로 변환할 파일 내 요소를 정의합니다.

  • 번역하지 않을 블록 

    가져오지 않아야 할 파일 내 섹션을 정의합니다.

    예:

    요소 이름: notrans.

    코드: <notrans>Chrysler</notrans>는 1985년 이벤트에 공장에서 준비한 <notrans>Dodge Shadows</notrans> 3대를 출전시켰습니다. 세 대의 차량 모두 3일간 진행된 <notrans>Olympus</notrans> 랠리 첫날에 중도 탈락했습니다.

    결과: Chrysler는 1985년 공장에서 준비한 3대의 Dodge Shadows를 대회에 출전시켰습니다.3대의 차량 모두 3일간 진행된 Olympus 랠리 첫날에 중도 탈락했습니다.

  • 글자를 이스케이프처리하지 않음 

    완성된 파일에서 이스케이프 처리되지 않아야 하는 문자 목록(예: #, -, [, <, \, `, ![, ](, :).

    MDX 필터를 사용하면 <와 { 모두 번역된 텍스트에서 기본적으로 이스케이프 처리됩니다. 이스케이프 처리되지 않은 < 또는 {가 번역문에 포함되면 MDX 구문이 손상되기 때문입니다. 출력에 이스케이프 처리되지 않은 원본 문자가 특별히 필요한 경우에만 여기에 추가하십시오.

MDX 관련 옵션

다음 네 가지 옵션은 필터에서 MDX가 선택된 경우에만 사용할 수 있습니다.

  • 번역 가능한 속성

    HTML 필터의 번역 가능한 속성 설정과 동일한 태그/속성 형식을 사용하여 번역할 추가 JSX 태그/속성 쌍을 정의합니다. 예를 들어, Figure/title는 Figure 구성 요소의 title 속성만 번역하는 반면, title(범위 지정되지 않음)은 모든 태그의 title 속성을 번역합니다.

    사용자 지정 구성 요소(<Figure>와 같이 대문자로 시작하는 태그 이름)는 기본적으로 번역 가능한 속성이 없으므로 여기에 명시적으로 나열하십시오. 소문자/HTML 스타일 태그(<img>, <a> 등)에는 이미 표준 속성 기본값이 있습니다.

  • 기본 번역 가능 속성 가져오기

    기본적으로 활성화되어 있습니다.

    번역 가능한 속성에 나열된 항목 외에도 소문자/HTML 스타일 태그에 표준 HTML 번역 가능 속성 기본값(예: <img>의 alt, <a>의 title)을 적용합니다. 사용자 지정 구성 요소는 이 설정과 관계없이 이러한 기본값을 받지 않습니다. 해당 속성은 번역 가능한 속성에 추가된 경우에만 번역할 수 있습니다.

    비활성화된 경우 소문자 태그에서도 번역 가능한 속성에 나열된 속성만 번역할 수 있습니다.

  • 요소를 기본적으로 번역 가능하게 만들기

    기본적으로 활성화되어 있습니다.

    JSX 구성 요소 내부의 텍스트를 기본적으로 번역할 수 있는지 여부를 설정합니다.

    • 활성화된 경우: 기본 번역 가능 여부를 재정의할 요소에 나열된 컴포넌트를 제외하고, 모든 컴포넌트(예: <Tabs>, <Note>) 내부의 텍스트를 번역할 수 있습니다.

    • 비활성화된 경우: 기본 번역 가능 여부를 재정의할 요소에 나열된 컴포넌트를 제외하고, 컴포넌트 내부의 텍스트는 번역할 수 없습니다.

  • 기본 번역 가능성을 재정의하는 요소

    기본적으로 요소를 번역 가능하게 만들기 설정과 반대로 처리할 컴포넌트 이름을 쉼표로 구분한 목록입니다.

    여기에 나열된 구성 요소는 전체적으로 전환됩니다. 즉, 내부에 중첩된 모든 구성 요소를 포함한 전체 콘텐츠가 재정의를 따르며 개별적으로 평가되지 않습니다. 재정의를 통해 구성 요소를 번역할 수 없게 설정하면 해당 콘텐츠는 작성된 그대로 보존됩니다. 이 목록을 사용하여 다음을 수행하십시오:

    • 기본적으로 요소를 번역 가능하게 만들기가 활성화된 경우 몇 가지 비산문 구성 요소(예: CodeGroup, Mermaid)를 제외하거나,

    • 해당 설정이 비활성화된 경우 산문이 포함된 구성 요소 몇 가지를 허용 목록에 추가하십시오.

JSX 콘텐츠가 처리되는 방식

이는 필터에서 MDX가 선택된 경우에 적용됩니다.

  • JSX 태그(<Component>, <Component attr="value" />)와 태그 및 속성 이름은 절대 번역할 수 없습니다. 요소 콘텐츠와 명시적으로 설정된 속성 값만 번역할 수 있습니다.

  • 중괄호({...}) 내의 표현식, JavaScript 표현식, 스프레드 속성({...props}) 및 주석({/* comment */})은 절대 번역할 수 없습니다. 이들은 속성이나 텍스트 중간, 또는 별도의 줄 등 어디에 나타나든 작성된 그대로 보존됩니다.

  • import 및 export 문은 파일 내 어디에 나타나든 항상 번역에서 제외됩니다.

도움이 되었습니까?
★ ★ ★ ★ ★

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.