이스케이프 문자
이스케이프 문자를 사용하면 Markdown에서 특별한 의미를 가진 문자를 표시할 수 있습니다. 문자 앞에 백슬래시 \
를 추가하면 해당 문자의 특별한 기능을 취소할 수 있습니다.
기본 이스케이프 개념
이스케이프란 무엇인가
Markdown에서 일부 문자는 특별한 의미를 가집니다 (예: *
는 강조용). 이러한 문자 자체를 표시하려면 이스케이프를 사용해야 합니다.
이것은 *이탤릭* 텍스트입니다.
이것은 \*일반 별표\* 텍스트입니다.
렌더링 결과:
이것은 이탤릭 텍스트입니다. 이것은 *일반 별표* 텍스트입니다.
이스케이프가 필요한 문자
전체 목록
다음 문자들은 Markdown에서 특별한 의미를 가지며 이스케이프가 필요합니다:
문자 | 설명 | 이스케이프 문법 | 용도 |
---|---|---|---|
\ | 백슬래시 | \\ | 이스케이프 문자 |
` | 백틱 | \` | 인라인 코드 |
* | 별표 | \* | 강조, 목록 |
_ | 밑줄 | \_ | 강조 |
{} | 중괄호 | \{ \} | 확장 문법 |
[] | 대괄호 | \[ \] | 링크, 이미지 |
() | 괄호 | \( \) | 링크, 이미지 |
# | 해시 | \# | 제목 |
+ | 플러스 | \+ | 목록 |
- | 대시 | \- | 목록, 수평선 |
. | 마침표 | \. | 순서 있는 목록 |
! | 느낌표 | \! | 이미지 |
일반적인 이스케이프 예시
별표와 밑줄
❌ 이스케이프하지 않음:
이 파일명은 file_name_v2.txt입니다
이 공식은 2*3*4 = 24입니다
✅ 이스케이프함:
이 파일명은 file\_name\_v2.txt입니다
이 공식은 2\*3\*4 = 24입니다
렌더링 결과:
❌ 이스케이프하지 않음: 이 파일명은 file_name_v2.txt입니다 이 공식은 234 = 24입니다
✅ 이스케이프함: 이 파일명은 file_name_v2.txt입니다 이 공식은 2*3*4 = 24입니다
해시 제목
❌ 이스케이프하지 않음:
# TODO: 작업 완료
✅ 이스케이프함:
\# TODO: 작업 완료
렌더링 결과:
❌ 이스케이프하지 않음:
TODO: 작업 완료
✅ 이스케이프함: # TODO: 작업 완료
목록 기호
❌ 이스케이프하지 않음:
가격: 100 - 200 USD
단계: 1. 준비 2. 실행
✅ 이스케이프함:
가격: 100 \- 200 USD
단계: 1\. 준비 2\. 실행
렌더링 결과:
❌ 이스케이프하지 않음: 가격: 100 - 200 USD 단계: 1. 준비 2. 실행
✅ 이스케이프함: 가격: 100 - 200 USD 단계: 1. 준비 2. 실행
링크 문법
❌ 이스케이프하지 않음:
문서를 [여기](http://example.com)에서 확인하세요
✅ 이스케이프함 (원시 문법 표시):
문서를 \[여기\]\(http://example.com\)에서 확인하세요
렌더링 결과:
❌ 이스케이프하지 않음: 문서를 여기에서 확인하세요
✅ 이스케이프함 (원시 문법 표시): 문서를 [여기](http://example.com)에서 확인하세요
특수한 경우
백슬래시 자체
백슬래시 문자를 표시하려면 이중 백슬래시를 사용합니다:
파일 경로: C:\\Users\\Username\\Documents
Unix 경로: /home/user/documents
렌더링 결과:
파일 경로: C:\Users\Username\Documents Unix 경로: /home/user/documents
백틱 이스케이프
코드에서 백틱을 표시하려면:
코드를 감싸려면 `` \` ``를 사용하세요
코드 블록을 만들려면 ``` \`\`\` ```를 사용하세요
렌더링 결과:
코드를 감싸려면 \`
를 사용하세요 코드 블록을 만들려면 \`\`\`
를 사용하세요
줄 끝의 백슬래시
줄 끝의 백슬래시는 특별한 의미를 가집니다 (강제 줄바꿈):
첫 번째 줄\
두 번째 줄 (강제 줄바꿈)
첫 번째 줄\\
두 번째 줄 (백슬래시 표시)
렌더링 결과:
첫 번째 줄
두 번째 줄 (강제 줄바꿈)
첫 번째 줄\ 두 번째 줄 (백슬래시 표시)
## 코드 내부 이스케이프
### 인라인 코드
인라인 코드에서는 대부분의 문자가 이스케이프가 필요하지 않습니다:
```markdown
코드: `let result = 2 * 3 + 1;`
경로: `C:\Users\*\Documents`
렌더링 결과:
코드: let result = 2 * 3 + 1;
경로: C:\Users\*\Documents
코드 블록
코드 블록에서는 문자가 그대로 유지됩니다:
```javascript
// 이스케이프가 필요하지 않은 기호들
const pattern = /[.*+?^${}()|[\]\\]/g;
const path = "C:\\Users\\*\\Documents";
```
렌더링 결과:
// 이스케이프가 필요하지 않은 기호들
const pattern = /[.*+?^${}()|[\]\\]/g;
const path = "C:\\Users\\*\\Documents";
실제 응용 시나리오
1. 기술 문서
## 설정 파일 문법
설정 파일은 다음 형식을 사용합니다:
# 주석 줄 key = value [섹션]
참고:
- \#으로 주석 시작
- \[\]로 섹션 정의
- \*를 와일드카드로 사용
2. 수학 표현
## 수학 공식
선형 방정식: y = a\*x + b
이차 방정식: y = a\*x² + b\*x + c
분수: 1/2 = 0.5
참고: \*를 곱셈 연산자로 사용
3. 파일 경로
## 파일 시스템
윈도우 경로:
- 시스템 디렉토리: C:\\Windows\\System32
- 사용자 디렉토리: C:\\Users\\{username}
- 프로그램 디렉토리: C:\\Program Files\\*
리눅스 경로:
- 루트 디렉토리: /
- 사용자 디렉토리: /home/{username}
- 와일드카드: /var/log/\*.log
4. 특수 기호 설명
## 기호 의미
프로그래밍:
- \*는 포인터 또는 와일드카드를 의미합니다
- \_는 명명 규칙 (예: \_private)을 의미합니다
- \#는 주석 또는 전처리 지시자를 의미합니다
- \[\]는 배열 또는 선택적 매개변수를 의미합니다
- \{\}는 코드 블록 또는 자리 표시자를 의미합니다
이스케이프 모범 사례
1. 필요할 때만 이스케이프
✅ 권장: 모호한 문자만 이스케이프
파일명: config.txt
가격: $10-20
❌ 권장하지 않음: 과도한 이스케이프
파일명: config\.txt
가격: \$10\-20
2. 일관성 유지
✅ 권장: 일관된 이스케이프 스타일
변수명: user\_id, item\_count, max\_size
❌ 권장하지 않음: 불일관적인 처리
변수명: user_id, item\_count, max_size
3. 코드 포맷팅 사용
많은 특수 문자가 있을 때 코드 포맷팅을 고려하세요:
✅ 권장: 코드 포맷팅 사용
설정 문법: `[섹션]` 및 `key=value`
❌ 권장하지 않음: 과도한 이스케이프
설정 문법: \[섹션\] 및 key\=value
일반적인 실수
1. 이스케이프 누락
❌ 오류:
My GitHub username is user_name
This function is called get_data()
✅ 정확:
My GitHub username is user\_name
This function is called get\_data()
2. 과도한 이스케이프
❌ 오류:
Today is 12\-25
This file is README\.md
✅ 정확:
Today is 12-25
This file is README.md
3. 컨텍스트 오류
❌ 오류: 코드 블록 내부 이스케이프
let path = "C:\Users\Name"; ← 이중 이스케이프가 필요하지 않습니다
✅ 정확:
let path = "C:\Users\Name";
HTML 출력
이스케이프 문자의 HTML 출력:
이것은 \*별표\* 텍스트입니다
변환된:
<p>이것은 *별표* 텍스트입니다</p>
에디터 및 도구
이스케이프 미리보기 지원 에디터
- Visual Studio Code: Markdown Preview Enhanced
- Typora: 실시간 미리보기
- Mark Text: WYSIWYG
- Obsidian: 실시간 렌더링
이스케이프 검사 도구
<!-- markdownlint rules -->
MD049: 강조 마커 일관성
MD050: 강조 마커 스타일
관련 문법
연습
다음을 정확하게 표시하려면 시도하세요:
- 파일 경로:
C:\Program Files\*\config.ini
- 변수명:
user_id
,file_name
,max_count
- 수학 표현:
2*x + 3*y = 15
- 설정 문법:
[섹션]
및key=value
- Markdown 문법:
**굵게**
및*이탤릭*
참고 표
일반적인 이스케이프 빠른 참고
원본 | 이스케이프됨 | 설명 |
---|---|---|
\ | \\ | 백슬래시 |
* | \* | 별표 |
_ | \_ | 밑줄 |
# | \# | 해시 |
[ | \[ | 왼쪽 대괄호 |
] | \] | 오른쪽 대괄호 |
( | \( | 왼쪽 괄호 |
) | \) | 오른쪽 괄호 |
+ | \+ | 플러스 |
- | \- | 대시/하이픈 |
. | \. | 마침표 |
! | \! | 느낌표 |