마크다운 볼드체(Strong Emphasis) 작성 규칙 가이드

마크다운(Markdown) 문서 작성 시 문장 강조를 위해 double asterisks(**)를 사용할 때, 한국어 문장 부호(따옴표 등)가 인접해 있으면 일부 마크다운 파서(예: Hugo의 Goldmark 등)에서 볼드체 스타일이 정상적으로 렌더링되지 않고 소스 코드(**) 형태로 그대로 노출되는 오류가 발생할 수 있습니다.

이 문서에서는 이러한 오류가 발생하는 원인과 올바른 작성 규칙을 정리합니다.

1. 렌더링 오류가 발생하는 원인

CommonMark 사양에 따르면, 볼드체 강조(**) 지시어는 문맥 상 좌우 공백이나 문장 부호의 위치에 따라 시작(Left-flanking) 및 끝(Right-flanking) 토큰 여부가 엄격하게 판별됩니다.

• ** 바로 뒤에 따옴표(‘, ’, ", ')나 괄호가 붙는 경우 파서가 이것을 ‘단어의 시작’이 아니라 ‘문장 부호’로 인식하여 강조 표시의 시작점으로 해석하지 못할 수 있습니다.
• 반대로 강조 블록이 닫힐 때 문장 부호 바로 앞에 **가 오면 닫는 태그 인식이 실패할 수 있습니다.

❌ 오류 발생 예시 (Bad Cases)

• **‘구조적 개선’** ➔ 일부 파서에서 강조 처리 실패 (따옴표가 볼드 기호 안쪽에 위치)
• **"의사결정 시뮬레이션"** ➔ 일부 파서에서 강조 처리 실패

2. 해결 방안 및 올바른 작성 규칙

이를 방지하기 위해 마크다운을 작성할 때는 아래와 같은 규칙을 권장합니다.

규칙 ①: 문장 부호(따옴표)를 강조 영역 바깥으로 빼기 (추천)

강조하고자 하는 핵심 단어만 볼드 처리하고, 문장 부호는 강조 기호 바깥에 작성합니다. 이렇게 하면 100% 모든 마크다운 엔진에서 정확하게 볼드체가 렌더링됩니다.

• 올바른 표기: ‘**구조적 개선**’ (볼드 렌더링 성공)
• 올바른 표기: “**의사결정 시뮬레이션**” (볼드 렌더링 성공)

규칙 ②: 강조 영역 내부에서 따옴표 제거하기 (추천)

강조하는 단어 자체에 이미 시각적인 강조 효과(볼드체)가 들어가므로, 불필요한 따옴표를 아예 제거하는 것이 문맥 전달과 가독성 측면에서 가장 깔끔합니다.

• 올바른 표기: **구조적 개선** (볼드 렌더링 성공)
• 올바른 표기: **의사결정 시뮬레이션** (볼드 렌더링 성공)

3. 요약 표

앞으로 로드맵 콘텐츠 및 시험 가이드 문서를 수정/작성할 때 본 규칙을 참조하여 렌더링 오류를 미연에 방지해 주시기 바랍니다.