본문 바로가기

Markdown 경로 재작성기

브라우저 처리

Markdown 링크·이미지 경로의 앞부분을 규칙대로 바꿉니다. '../docs/ => /guide/'처럼 여러 규칙을 한 줄씩 적고, 참조 정의 경로도 함께 고칩니다.

사용 전 확인
  • 파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.
도구 실행입력 후 결과 확인
Markdown 경로 재작성기 샘플 실행

문서를 다른 폴더나 사이트로 옮기면 '../img/a.png' 같은 상대 경로를 '/static/img/a.png'처럼 새 위치에 맞게 바꿔야 합니다. 링크가 수십 개면 손으로 고치다 빠뜨리기 쉬워, 이 도구가 규칙에 맞는 경로 앞부분만 골라 바꿔 줍니다.

브라우저 처리
샘플 결과
[가이드](/guide/start.md)
![화면](/static/img/a.png "메인")
[참고](ref.md)
자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

Markdown 경로 재작성기 사용 가이드

문서를 다른 폴더나 사이트로 옮기면 '../img/a.png' 같은 상대 경로를 '/static/img/a.png'처럼 새 위치에 맞게 바꿔야 합니다. 링크가 수십 개면 손으로 고치다 빠뜨리기 쉬워, 이 도구가 규칙에 맞는 경로 앞부분만 골라 바꿔 줍니다.

규칙은 '바꿀 앞부분 => 새 앞부분' 형식으로 한 줄에 하나씩 적습니다. 각 링크는 위에서부터 처음 맞는 규칙 하나만 적용되고, './ =>'처럼 오른쪽을 비우면 그 앞부분을 지웁니다.

[글자](경로), ![설명](경로)와 문서 끝 '[키]: 경로' 참조 정의가 대상이며, 이미지 뒤의 "제목" 텍스트는 그대로 유지됩니다.

사용 방법

  1. 'Markdown 내용'에 경로를 바꿀 문서를 붙여 넣습니다.
  2. '경로 바꾸기 규칙 (예: ../ => /project/)' 칸에 '../img/ => /static/img/'처럼 규칙을 한 줄에 하나씩 적습니다.
  3. '실행'을 누르고 바뀐 경로를 확인한 뒤 '결과 복사' 또는 '다운로드'합니다.

예시: 문서와 이미지 경로를 각각 다른 곳으로

입력
Markdown 내용:
[가이드](../docs/start.md)
![화면](../img/a.png "메인")
[참고](./ref.md)

경로 바꾸기 규칙:
../docs/ => /guide/
../img/ => /static/img/
./ =>
결과
[가이드](/guide/start.md)
![화면](/static/img/a.png "메인")
[참고](ref.md)

세 번째 규칙은 오른쪽이 비어 있어 './'를 지웠습니다. 이미지 제목 "메인"은 그대로입니다.

이럴 때 쓰면 좋아요

  • GitHub 저장소 문서를 문서 사이트로 옮기며 상대 경로를 절대 경로로 바꿀 때
  • 이미지 폴더 이름을 images에서 assets로 바꾼 뒤 문서 경로를 맞출 때
  • 블로그 원고의 로컬 이미지 경로를 CDN 주소로 일괄 변경할 때
  • 여러 단계의 '../' 경로를 정리된 새 폴더 구조에 맞출 때

문제가 생겼을 때

'../ => /project/' 형식으로 적으라는 오류

규칙 칸이 비었거나 => 왼쪽이 비어 있으면 나옵니다. '바꿀 앞부분 => 새 앞부분'을 한 줄에 하나씩 적으세요. =>가 없으면 공백으로 두 부분을 나눕니다.

경로 중간 부분이 바뀌지 않음

규칙은 경로의 맨 앞부분만 비교합니다. 'img/'가 경로 중간에 있으면 맞지 않으니 '../img/'처럼 경로 시작부터 적으세요.

활용 팁

  • 구체적인 규칙을 위에 적으세요. '../'보다 '../img/'를 먼저 두어야 이미지 경로가 넓은 규칙에 먼저 걸리지 않습니다.
  • 바꾼 뒤에는 Markdown 로컬 링크·이미지 검사기로 새 경로의 파일이 실제로 있는지 확인하면 안전합니다.

자주 묻는 질문

웹 주소(https://)도 바뀌나요?

규칙의 왼쪽과 앞부분이 일치하면 바뀝니다. 'http://old.com/ => https://new.com/' 규칙으로 도메인 이전에도 쓸 수 있습니다.

HTML <img src>도 바꿔 주나요?

아니요. Markdown 링크·이미지와 참조 정의만 바꿉니다. 문서에 섞인 HTML 태그의 경로는 찾기·바꾸기로 따로 고치세요.

경로에 공백이 있으면 어떻게 하나요?

'=>'를 써서 규칙을 적으면 양쪽 경로에 공백이 있어도 됩니다. 다만 Markdown 링크 자체도 공백이 든 경로를 잘 처리하지 못하니 %20으로 바꾸는 편이 안전합니다.