마크다운 문서 주석 제거 공식과 빌드 타임 주석 스트리핑 규칙

깃허브(GitHub)의 오픈소스 리드미(README.md) 파일을 다듬거나 기술 문서 번역을 공동 작업하다 보면, 외부에 노출하고 싶지 않은 내부 메모나 번역 참고용 문장을 마크다운(Markdown) 주석으로 감추어 기재해 두는 경우가 많습니다.
하지만 최종 배포판(Static Build)을 만들어 배포하거나 일반 독자에게 마크다운 문서를 공개하는 시점에는, 이런 내부용 HTML 주석이 텍스트 소스에 그대로 남아 노출되는 경우가 있습니다. 이 글에서는 마크다운 문서 안의 HTML 주석만 골라 제거하는 정규식 원리와 자주 놓치는 예외를 정리합니다.
1. 마크다운 HTML 주석을 지우는 정규식 원리
마크다운 스펙에서 쓰는 주석 형태는 HTML과 동일한 <!-- 주석 내용 --> 구조입니다. 이 구조만 골라 문서 전체에서 제거하는 정규식은 다음과 같습니다.
/<!--[\s\S]*?-->/g
정규식이 하는 일
<!--,-->: 주석의 시작과 끝 경계입니다.[\s\S]*?: 개행 문자(\s)와 비개행 문자(\S)를 모두 포함해, 줄바꿈이 들어간 여러 줄 주석까지 잡아냅니다.- 물음표(
?)는 비탐욕적(non-greedy) 매칭입니다. 이게 빠지면 문서에 주석이 여러 개 있을 때 첫 번째 주석의 시작부터 마지막 주석의 끝까지를 통째로 지워버리는 오작동이 납니다.
이 정규식을 문자열 치환 함수에 넘기면 주석만 빠진 결과를 얻습니다.
cleanedText = originalText.replace(/<!--[\s\S]*?-->/g, "")
2. 빌드 과정에 주석 제거를 끼워 넣는 법
실무에서는 마크다운을 HTML로 변환하는 빌드 단계에 이 치환을 넣어 자동화합니다.
// Next.js 등 정적 사이트의 마크다운 파이프라인 예시
function markdownLoader(content) {
// 컴파일 직전에 HTML 주석을 제거해
// 내부용 문구가 배포 결과물에 남지 않게 합니다.
const cleanContent = content.replace(/<!--[\s\S]*?-->/g, "");
return marked.parse(cleanContent);
}
매번 에디터에서 찾기(Ctrl+F)로 주석을 눈으로 확인하며 지우거나, 깃에 올리기 전에 수동으로 검사할 필요는 없습니다. 아래 마크다운 주석 제거기에 원문을 붙여넣으면 같은 정규식으로 주석만 골라 제거한 결과를 바로 복사할 수 있습니다. 지운 자리에 빈 줄이 남는 게 싫으면 "빈 줄 정리" 옵션을 함께 켜면 되고, 몇 개의 주석이 제거됐는지도 화면에 함께 표시됩니다.
주석 정리가 필요한 마크다운 문장을 복사해 넣고 일괄 주석 제거 단추를 클릭하여 외부에 안전하게 공유 가능한 깨끗한 배포용 문안을 확보해 보세요.

3. 주석을 지울 때 흔히 놓치는 예외
| 상황 | 주의할 점 |
|---|---|
예제 코드 안에 <!-- 문자열이 그대로 들어 있는 경우 | 코드 예제로 보여주려고 적어 둔 <!-- 문자열까지 같이 지워집니다. 코드 블록 영역을 먼저 따로 떼어냈다가 주석 제거 후 되돌려야 합니다. |
Jekyll·Astro 등의 프런트매터(문서 맨 위 --- 구간) | 문서 최상단 YAML 메타데이터도 주석 정규식 범위에 걸릴 수 있어, 줄 단위로 프런트매터 영역을 구분해 제외해야 합니다. |
| 여러 주석이 떨어져 있는 문서 | 비탐욕적(?) 매칭이 빠지면 앞서 설명한 대로 첫 주석부터 마지막 주석까지 통째로 지워집니다. |
정리
마크다운 HTML 주석은 /<!--[\s\S]*?-->/g 정규식으로 제거할 수 있습니다. 비탐욕적 매칭을 빼먹지 않아야 여러 주석이 있는 문서에서 중간 본문까지 날아가는 사고를 막을 수 있고, 코드 예제 안의 <!-- 문자열과 프런트매터 영역은 별도로 처리해야 안전합니다. 직접 정규식을 돌리기 번거로우면 도구에 원문을 붙여넣어 바로 결과를 확인할 수 있습니다.
주석 정리가 필요한 마크다운 문장을 복사해 넣고 일괄 주석 제거 단추를 클릭하여 외부에 안전하게 공유 가능한 깨끗한 배포용 문안을 확보해 보세요.
자주 묻는 질문
주석 안에 마크다운 문법이 들어 있어도 지워지나요?
네. <!-- --> 사이의 내용은 형식과 무관하게 통째로 제거 대상입니다. 안에 마크다운 문법이나 일반 텍스트가 섞여 있어도 주석 경계(<!--, -->) 기준으로 지워집니다.
HTML 파일에도 같은 정규식을 쓸 수 있나요?
네, HTML 주석 표기가 같으므로 같은 패턴이 그대로 동작합니다. 다만 HTML은 <script>·<style> 태그 안에 비슷한 문자열이 들어갈 수 있어, 마크다운보다 예외를 한 번 더 확인하는 편이 안전합니다.