마크다운의 상대 경로를 절대 URL로 변환하는 제로 의존성 Python 도구
중간맛 분석
Python으로 만들었고 외부 라이브러리 없이 독립적으로 동작합니다. 상대 경로를 절대 URL로 해석하는 기본 기능과, 이미지를 Base64로 인라인하는 고급 기능을 제공합니다. 인증이 필요한 이미지 다운로드를 위해 custom HTTP 헤더를 지원하며, 타임아웃이나 404 에러 발생 시 안전하게 폴백합니다. RAG 파이프라인이나 멀티모달 LLM(GPT-4o, Claude 3.5) 전처리 단계에서 즉시 사용할 수 있습니다.
이런 레포예요
이럴 때 쓰면 좋아요
- 웹 스크래핑한 마크다운 문서를 LLM에 입력하기 전 링크 정상화
- RAG 시스템에서 검색된 문서의 상대 이미지 경로를 절대 URL 또는 Base64로 변환
- GPT-4o, Claude 같은 비전 모델에 보낼 마크다운 콘텐츠 준비
핵심 기능
대안 대비 차별점
외부 라이브러리 없이 순수 Python 표준 라이브러리만 사용하면서도 멀티모달 LLM과 RAG 파이프라인을 위한 이미지 인라인 및 인증 기능을 제공합니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Python 3.x
바로 차려먹기Python (uv)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/Encephos/markdown-link-resolver.git && cd markdown-link-resolver && uv sync
uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- 패키지 설치
pip install markdown-link-resolver
- 기본 사용법 - 상대 경로를 절대 URL로 변환
from markdown_link_resolver import resolve_markdown_links
base_url = "https://example.com/blog/"
dirty_markdown = "Check out our [about us](../about) page or our ."
clean_markdown = resolve_markdown_links(dirty_markdown, base_url)
print(clean_markdown)
# 출력: Check out our [about us](https://example.com/about) page or our .
- 이미지 Base64 인라인 (멀티모달 LLM용)
auth_headers = {
"Authorization": "Bearer YOUR_API_TOKEN"
}
md_with_images = "Look at this chart: "
prepared_md = resolve_markdown_links(
md_with_images,
base_url="https://secure.example.com/",
inline_images=True,
headers=auth_headers
)
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try Encephos/markdown-link-resolver
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「데이터·크롤링」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/Encephos/markdown-link-resolver)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기