Skip to content

[버그] markdownToHwpx — 중첩 인라인 강조(**a *b* c**)가 별 리터럴 노출·굵게 소실로 깨짐 #61

Closed

Description

@LeeYudok

증상

markdownToHwpx 에서 중첩 인라인 강조 — 굵게 안에 기울임(**a *b* c**), 기울임 안에 굵게(*a **b** c*) — 가 들어간 문단을 변환하면:

  • 별표 * 가 본문 글자로 그대로 노출됩니다
  • 굵게 서식이 통째로 소실되고, 굵게였어야 할 구간이 기울임으로 뒤집힙니다
  • 안쪽 기울임 구간은 반대로 평문이 됩니다

LLM이 작성한 마크다운(MCP generate_document 경로)에 특히 흔한 패턴이라 실사용 노출이 큽니다.

재현

import { markdownToHwpx, parse } from "kordoc"

const hwpx = await markdownToHwpx("**굵게 *기울임* 다시**")
const r = await parse(Buffer.from(hwpx))
console.log(r.blocks[0].spans)

v4.4.0 결과 — 별 리터럴 2개 + 서식 역전:

[
  { text: "*" },
  { text: "굵게 ", italic: true },   // 굵게였어야 함
  { text: "기울임" },                // 굵게+기울임이었어야 함
  { text: " 다시", italic: true },   // 굵게였어야 함
  { text: "*" },
]

렌더 비교 (공문서 프리셋 보고서, kordoc render)

같은 마크다운 입력, 같은 렌더러이고 차이는 수정 커밋 하나입니다. 재현 샘플·hwpx 원본은 demo/nested-emphasis-assets 브랜치에 있습니다.

수정 전 (v4.4.0) 수정 후
before after

수정 전: * 서식 오류가 반복 발생* 처럼 별표 8개 노출 + 중첩 구간 굵게 전멸. 수정 후: 별표 0건, 안쪽 구간(2회·37%·12건)까지 굵게 적용.

원인

src/hwpx/md-runs.ts 의 인라인 강조 정규식이 flat 패턴입니다:

\*{2}[^*]+\*{2}   ← **bold** 내용에 * 를 허용하지 않음

중첩 강조가 들어오면 bold 대안이 매칭에서 통째로 탈락하고, 그 자리를 \*[^*]+\* (기울임) 가 **굵게 * → * 다시** 식으로 어긋나게 잘라 먹으면서 위 결과가 됩니다.

수정 제안

  • */**/*** 패턴이 안쪽의 더 짧은 별 run 을 허용하도록 확장
  • 매칭된 강조 내부를 재귀(상한 3)로 분해해 겉 강조 플래그를 OR — **a _u_ b**, __a *i* b__ 교차 중첩, 굵게 안 인라인 코드까지 처리
  • 단독 강조·이스케이프(\*)·snake_case 비활성·미닫힘 폴백은 종전 출력 그대로 (기존 테스트 무수정 통과)

수정 브랜치 준비돼 있어 바로 PR 올리겠습니다.

Activity

  1. added a commit that references this issue on Aug 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions