Markdown문서화

인라인 코드와 escaping

짧은 명령어를 표시하는 인라인 코드와 Markdown 기호를 문자 그대로 보여 주는 escaping 규칙을 정리합니다.

마지막 수정 2026년 3월 19일

기본 패턴

text
`git status`
\*별표\*를 문자 그대로 보여 주기
``code with `backtick` inside``

설명

  • 인라인 코드는 명령어, 옵션, 파일명, 변수명처럼 본문 안 짧은 리터럴을 표시할 때 적합합니다.
  • backtick 하나로 감싸는 것이 기본이지만, 코드 안에 backtick이 들어가면 감싸는 fence를 더 길게 잡을 수 있습니다.
  • Markdown 기호를 문자 그대로 보여 주고 싶으면 앞에 \를 붙여 escaping합니다.
  • escaping은 코드 span 안이 아니라 일반 텍스트에서 특히 중요합니다.

짧은 예제

text
`npm run build`를 실행한 뒤 `dist/` 폴더를 확인합니다.
문장 안에서 \# 해시는 제목이 아니라 문자로 보입니다.

빠른 정리

문법설명
`code`인라인 코드
\*Markdown 기호를 문자 그대로 표시
긴 backtick fence코드 안 backtick을 감싸야 할 때 사용
리터럴 표시명령어, 경로, 옵션을 문장 속에서 구분해 줌
escape 위치일반 텍스트에서 가장 자주 필요

주의할 점

코드 span 안에서는 backslash escape가 기대대로 동작하지 않을 수 있습니다. backtick이 포함된 예시는 감싸는 backtick 개수를 늘려 해결하는 편이 더 자연스럽습니다.

참고 링크

2 sources