목록으로 돌아가기
텍스트4분 소요최종 수정: 2026. 11. 2.

마크다운이란? 언제 마크다운 제거가 필요할까요?

마크다운 문법의 기초와 순수 텍스트 변환이 필요한 상황을 설명합니다.

작성: webgyver

마크다운(Markdown)이란?

마크다운은 2004년 존 그루버가 만든 경량 마크업 언어입니다. 읽기 쉽고 쓰기 쉬운 일반 텍스트 형식으로, HTML로 변환할 수 있도록 설계되었습니다.

마크다운의 철학은 '읽는 그대로가 의미를 전달해야 한다'는 것입니다. 예를 들어 **굵은 텍스트**는 별표로 감싸고, # 제목은 해시 기호로 시작합니다. 복잡한 태그 없이도 문서 구조를 표현할 수 있습니다.

오늘날 마크다운은 GitHub, GitLab, Notion, Obsidian, 대부분의 개발 문서화 도구에서 표준으로 사용됩니다. README 파일, 기술 문서, 블로그 포스트 작성에 널리 활용됩니다.

기본 마크다운 문법

제목은 # 기호로 표시합니다. #의 개수가 제목의 레벨을 나타냅니다. # 제목1, ## 제목2, ### 제목3 순으로 사용합니다.

텍스트 강조는 별표나 언더스코어를 사용합니다. *이탤릭*, **굵게**, ***굵은 이탤릭***으로 표시합니다. 취소선은 ~~텍스트~~로 표현합니다.

링크는 [텍스트](URL) 형식으로, 이미지는 ![대체텍스트](이미지URL) 형식으로 삽입합니다. 코드는 백틱(`)으로 감싸거나, 코드 블록은 세 개의 백틱(```)으로 감쌉니다.

마크다운 제거가 필요한 상황

마크다운을 지원하지 않는 플랫폼에 텍스트를 붙여넣을 때 문법 기호가 그대로 보입니다. 이메일, 워드 프로세서, 일부 SNS에서는 마크다운이 렌더링되지 않아 가독성이 떨어집니다.

문서에서 순수한 텍스트만 추출하고 싶을 때 필요합니다. 예를 들어 마크다운 문서의 내용을 음성 합성(TTS)에 사용하거나, 텍스트 분석을 수행할 때 문법 기호가 방해됩니다.

콘텐츠를 다른 형식으로 마이그레이션할 때 마크다운 문법을 먼저 제거하고 새로운 형식으로 변환하는 것이 깔끔할 수 있습니다. 특히 복잡한 마크다운에서 서식 정보 없이 내용만 옮길 때 유용합니다.

마크다운 제거기 사용 팁

TheWebGyver의 마크다운 제거기는 remark 파서를 기반으로 정확하게 마크다운을 해석합니다. 단순 정규식 기반 도구보다 복잡한 중첩 구조도 올바르게 처리합니다.

코드 블록 내의 텍스트도 추출됩니다. 기술 문서에서 코드와 설명을 분리할 필요 없이 전체 내용을 한 번에 변환할 수 있습니다.

변환 결과를 미리보기로 확인하고, 한 번의 클릭으로 클립보드에 복사할 수 있습니다. 브라우저에서 모든 처리가 이루어지므로 문서 내용이 외부로 전송되지 않습니다.

오해와 진실: 마크다운은 하나의 표준이 아닙니다

마크다운 문법은 정해져 있으니 어디서나 똑같이 동작한다는 생각은 절반만 맞습니다. CommonMark 명세는 존 그루버의 원래 설명 문서가 문법을 모호하지 않게 정해 놓지 않았다고 직접 밝힙니다. 그 빈틈을 메우려고 만든 것이 CommonMark이고, 여기서는 제목을 # 기호 1개에서 6개까지로, 제목 수준을 # 개수와 같게 정의합니다.

두 번째 오해는 표와 취소선도 기본 문법이라는 생각입니다. GitHub의 GFM(GitHub Flavored Markdown) 명세에서 표는 Tables (extension), 취소선과 체크박스 목록(task list)도 확장으로 정의됩니다. 파이프(|)로 칸을 나누는 표나 ~~취소선~~은 CommonMark 기본이 아니라 GFM이 더한 문법이어서, 어떤 편집기에서는 표로 그려지고 다른 곳에서는 기호가 그대로 보일 수 있습니다.

세 번째 오해는 기호가 보이면 서식이 깨진 것이라는 생각입니다. 그루버의 문법 문서는 마크다운 문서가 일반 텍스트 그대로 공개해도 되는 모습이어야 한다고 설명합니다. 별표와 샵은 오류가 아니라 원문에 원래 있는 읽기용 표시이고, 렌더링되지 않는 곳에서 그대로 보이는 것은 설계 의도에 가깝습니다.

정규식으로 지우는 방법과 파서로 지우는 방법 비교

가장 쉬운 방법은 정규식으로 별표와 샵을 지우는 것입니다. 별표 몇 개를 정리하는 정도라면 충분하지만 문법에는 예외가 많습니다. 예컨대 CommonMark는 밑줄이 단어 안쪽에서는 강조를 만들지 않는다고 규정하며, foo_bar_baz가 그 예입니다. 변수명이나 파일명의 밑줄은 서식이 아니라 내용이므로, 밑줄을 모두 지우는 정규식은 snake_case 이름을 망가뜨립니다.

코드도 문제입니다. 명세는 코드 스팬 안에서는 백슬래시 이스케이프가 동작하지 않는다고 적고 있어서, 코드 안의 기호는 서식이 아니라 그대로 보존해야 하는 내용입니다. 또 문장 끝에 공백 두 칸 이상이나 백슬래시를 두면 강제 줄바꿈이 되는데, 이 줄 끝 백슬래시는 서식 표시이므로 결과에 남으면 안 됩니다. 별표와 샵만 겨냥한 정규식은 이런 기호를 놓칩니다.

파서 기반 변환은 문서를 먼저 제목, 문단, 목록, 코드, 링크 같은 구조로 읽은 뒤 그 구조에서 텍스트만 꺼내므로 이런 예외를 문법 규칙에 맡길 수 있습니다. TheWebGyver의 마크다운 제거기가 remark 파서를 쓰는 이유도 같습니다. 대신 파서는 문서를 올바른 마크다운으로 해석하기 때문에, 규칙에 맞지 않는 기호(예를 들어 짝이 맞지 않는 별표)는 서식이 아닌 일반 문자로 취급되어 결과에 남을 수 있다는 점은 알아 두세요.

지우기 전에 확인할 항목: 요소별 판단 가이드

표는 가장 신중하게 다룰 요소입니다. GFM 표는 파이프로 칸을 나누고 둘째 줄에 하이픈으로 된 구분 행을 두는 구조라서, 기호만 지우면 열이 구분되지 않은 텍스트가 됩니다. 표 구조가 일반 텍스트에서 사라지는 것은 워드프로세서도 마찬가지입니다. Microsoft는 Word의 텍스트만 유지(Keep Text Only) 붙여넣기가 표를 일련의 문단으로 바꾼다고 설명합니다. 표의 구조가 중요한 문서라면 텍스트로 만들기보다 표 형태로 옮기는 편이 낫습니다.

링크는 [글자](주소) 형태이므로 텍스트만 남기면 주소가 사라질 수 있습니다. 도구에 따라 처리 방식이 다르니 결과에 주소가 남았는지 확인하고, 참고 링크가 중요한 글이라면 본문 끝에 주소를 따로 적어 두세요. 목록은 하이픈이나 숫자 표기를 남길지 정하세요. 일반 텍스트에서도 하이픈 목록은 읽기 쉬워서 기호를 남기는 편이 나을 때가 많습니다. 체크박스 목록은 GFM 확장이므로 변환 뒤에 대괄호가 남아 있는지도 살펴보세요.

코드가 많은 글이라면 변환 대상에서 코드 블록을 빼고 따로 보관하는 편이 안전합니다. 코드는 한 글자의 차이로 동작이 달라지므로, 서식을 정리한다는 이유로 건드리지 않는 것이 좋습니다.

변환 후 검수: 5분 점검 절차

첫째, 원본과 결과를 나란히 두고 제목의 개수와 순서가 같은지 봅니다. 제목 기호만 지워지면 제목이 앞 문단에 붙어 보일 수 있으므로 문단 사이에 빈 줄이 남았는지 확인하세요. 둘째, 목록이 필요한 곳에 항목 구분이 남아 있는지 확인합니다. 셋째, 링크 주소와 표처럼 구조에 의존하는 정보가 사라지지 않았는지 대조합니다.

마지막으로 변환 결과를 최종 문서에 붙여넣은 뒤 한 번 소리 내어 읽어 보세요. 마크다운 기호가 사라졌는지보다 읽는 흐름이 자연스러운지가 최종 기준입니다. 규칙에 어긋난 별표나 밑줄이 일부 남아 있다면 해당 부분만 직접 지우면 됩니다.

변환 전에 원본을 별도 파일로 저장해 두는 습관도 권합니다. 표나 링크처럼 구조에 의존하는 정보를 나중에 다시 확인할 수 있기 때문입니다. 같은 문서를 여러 곳에 올려야 한다면 마크다운 원본은 그대로 보관하고, 마크다운을 이해하지 못하는 곳에 올릴 때만 변환본을 따로 만드는 흐름이 관리하기 쉽습니다. 이렇게 하면 나중에 문서를 고칠 때도 원본 한 곳만 수정하면 됩니다.

참고 자료

직접 사용해보기

이 글에서 다룬 내용을 Markdown Stripper로 직접 체험해보세요.

Markdown Stripper