Markdown Git 충돌 해결 도우미

Markdown Git 충돌 해결 도우미 사용 가이드

여러 사람이 같은 README나 문서를 고치면 Git 병합 중 '<<<<<<< HEAD … ======= … >>>>>>> feature' 같은 충돌 표시가 생깁니다. 기호가 뒤섞인 채로는 어느 쪽 내용이 무엇인지 읽기 어려운데, 이 도우미는 충돌 구간마다 두 버전을 주석으로 구분해 펼쳐 보여 줍니다.

각 충돌은 '<!-- 충돌 1: 내 쪽 (HEAD) -->'와 '<!-- 충돌 1: 들어온 쪽 (feature/login) -->' 아래에 각각의 내용이 놓이고, 브랜치 이름은 충돌 표시 줄에서 그대로 가져옵니다. diff3 형식의 '|||||||' 공통 조상 구간은 결정에 필요 없어 뺍니다.

어느 쪽을 남길지는 사람이 정해야 합니다. 결과 끝의 '펼친 충돌 N개' 안내대로 남길 쪽만 고르고 주석과 나머지를 지운 뒤 커밋하세요.

사용 방법

1. 1'충돌 표시가 있는 내용 (<<<<<<< … >>>>>>>)' 칸에 충돌이 난 파일 내용을 통째로 붙여 넣습니다.
2. 2'실행'을 누르면 충돌마다 내 쪽과 들어온 쪽이 주석으로 나뉘어 나옵니다.
3. 3남길 내용만 고르고 주석과 버릴 쪽을 지운 뒤, 결과를 원래 파일에 붙여 넣고 저장합니다.

앞
<<<<<<< HEAD
# 내 제목
||||||| base
# 원래 제목
=======
# 들어온 제목
>>>>>>> feature/login
뒤

앞
<!-- 충돌 1: 내 쪽 (HEAD) -->
# 내 제목

<!-- 충돌 1: 들어온 쪽 (feature/login) -->
# 들어온 제목
뒤

<!-- 펼친 충돌 1개 · 남길 쪽만 고르고 주석과 나머지를 지우세요 -->

이럴 때 쓰면 좋아요

• README 병합 충돌을 웹 편집기 없이 빠르게 정리할 때
• 충돌 기호 때문에 읽기 어려운 문서의 두 버전을 비교할 때
• Git에 익숙하지 않은 동료에게 어느 쪽이 무엇인지 보여 줄 때
• 여러 충돌이 있는 긴 문서에서 충돌 개수를 먼저 확인할 때

문제가 생겼을 때

활용 팁

• 두 버전 모두 필요한 경우가 많습니다. 예를 들어 서로 다른 항목을 목록에 추가했다면 두 내용을 합쳐 남기세요.
• 정리한 뒤 파일 안에 <<<<<<< 같은 기호가 남지 않았는지 찾기(Ctrl+F)로 한 번 더 확인하고 커밋하세요.

자주 묻는 질문