저는 제 프로젝트 AI-Powered Markdown Translator를 기쁘게 소개합니다. 이 오픈 소스 Python 스크립트는 OpenAI, Mistral AI, Anthropic(Claude), Google Gemini 같은 최첨단 인공지능 모델을 통합하여 제 블로그와 GitLab 저장소의 모든 Markdown 파일을 자동으로 번역합니다. 이 도구는 글, README, 기술 문서를 영어, 스페인어, 중국어 등 여러 언어로 번역하면서 구조와 포맷을 유지합니다. 이 프로젝트는 자동화, AI 통합, Python 개발에 대한 제 역량과 기술 콘텐츠를 모두가 이용할 수 있게 하려는 제 열정을 보여줍니다.
이것은 단순한 스크립트가 아니라 제 전문성과 더 포용적인 디지털 세상을 향한 비전의 증거입니다.
왜 이 프로젝트인가?
Markdown 파일은 제 디지털 생태계에서 핵심입니다: 블로그 글, 튜토리얼, 오픈 소스 문서들이 모두 Markdown으로 작성됩니다. 이들의 번역을 자동화함으로써 전 세계 독자들이 제 콘텐츠에 접근할 수 있게 되었습니다. 예를 들어, 이 스크립트 덕분에 제 블로그는 이제 14개 언어로 제공되어 영향력이 커졌습니다. 다음은 스크립트 작동 예시입니다 :
이 프로젝트는 AI가 실용적인 문제를 어떻게 해결하고 접근성을 높일 수 있는지를 보여줍니다.
제 기술 하이라이트
이 스크립트는 제 기술 역량을 보여주는 포트폴리오입니다. 강조되는 부분은 다음과 같습니다 :
- 다중 AI API 통합 :
gpt-5,mistral-large-latest,claude-sonnet-4-5, 및gemini-3-pro같은 모델들을 각 API의 특성에 맞게 연결했습니다. - 지능적 설계 : 스크립트는 고급 플레이스홀더 처리 기법으로 코드 블록, 링크, 메타데이터를 보존합니다.
- 복잡한 문제 해결 : 토큰 한도 관리나 Markdown 포맷 충실도와 같은 도전 과제를 극복했습니다.
- 오픈 소스 정신 : 이 프로젝트는 GitLab에서 공개되어 커뮤니티의 기여를 환영합니다.
이 요소들은 실용적이고 강력한 도구를 만들 수 있는 제 능력을 보여줍니다.
주요 기능
스크립트가 제공하는 기능은 다음과 같습니다 :
- Multi-Provider : 4개의 API(OpenAI, Mistral AI, Claude, Gemini) 지원
- 2026 모델 : 기본값으로 GPT-5, Claude Sonnet 4.5, Gemini 3 Pro
- 절약 모드 (
--eco) : 더 빠르고 비용이 적은 모델 (gpt-5-mini, claude-haiku, gemini-flash) - 단일 파일 (
--file) : 전체 디렉토리 대신 단일 파일 번역 - 이름 보존 (
--keep_filename) : 원본 이름과 확장자 유지(Astro, Hugo 등에 적합) .env지원 :.env파일에서 API 키 자동 로드.mdx파일 지원 : 전통적인.md파일 외에도 지원- 번역 메모 (
--add_translation_note) : 문서 끝에 사용된 모델을 기재하는 메모 추가 - 포맷 보존 : 코드 블록과 링크는 그대로 유지
- 프론트매터 처리 :
title및description번역,locale업데이트, 기타 메타데이터 보존
| Provider | Qualité (défaut) | Économique (--eco) |
|---|---|---|
| OpenAI | gpt-5 | gpt-5-mini |
| Claude | claude-sonnet-4-5 | claude-haiku-4-5 |
| Mistral | mistral-large-latest | mistral-small-latest |
| Gemini | gemini-3-pro-preview | gemini-3-flash-preview |
이 결과물은 제 작업과 자동화에 대한 열정의 산물입니다.
영향과 향후 전망
이 스크립트는 제 블로그와 오픈 소스 프로젝트를 언어 장벽 없이 더 많은 사람에게 열어줍니다. 단어를 번역하는 것을 넘어 기술 지식을 민주화합니다.
직접 사용해 보세요
프로젝트는 GitLab에서 확인하실 수 있습니다. 자신의 Markdown 파일로 테스트해 보시고 피드백을 공유해 주세요. 여러분의 아이디어가 프로젝트를 더욱 완성하게 합니다!
연락처 : contact@jls42.org
이 문서는 gpt-5-mini 모델을 사용하여 fr 버전에서 ko 언어로 번역되었습니다. 번역 과정에 대한 자세한 정보는 https://gitlab.com/jls42/ai-powered-markdown-translator를 참조하십시오.