Markdown 기술 문서를 번역할 때 코드 블록과 Front Matter는 어떻게 처리해야 합니까?
핵심 현황 진단
“기술 문서의 코드 블록, 인라인 코드 및 헤더 설정(Front Matter)은 강제로 번역할 경우 문서가 정상적으로 동작하지 않을 수 있습니다.”
근본 원인 분석
코드 블록의 '격리 구역' 메커니즘
시스템은 ``` (코드 블록) 및 ` (인라인 코드)로 감싼 내용을 자동으로 인식합니다. 이러한 영역은 '비번역 구역'으로 지정되어, AI가 해당 부분을 건너뛰어 Python, JS 등의 코드 논리가 손상되지 않도록 합니다.
Front Matter 메타데이터 보호
Jekyll, Hugo 등 정적 블로그에서 사용되는 YAML 헤더 설정(`date:`, `slug:` 등)은 `title`, `description` 등 특정 필드만 번역하며, 빌드에 필요한 구성 매개변수는 그대로 보존합니다.
Markdown 표의 자동 재정렬
Markdown 표(Table)는 번역 후 문자 길이 변화로 인해 종종 정렬이 어긋날 수 있습니다. DL.Translator는 후처리 단계에서 파이프 기호 `|`의 위치를 재계산하여, 정렬이 정확하고 보기 좋은 표 소스 코드를 출력합니다.
최종 솔루션 요약
오픈 소스 커뮤니티와 개발자를 위해 설계되어, README.md 및 기술 튜토리얼이 다국어 전환 시에도 전문성과 가독성을 유지합니다.