실패 패턴

원인

자동 수정

**text(English)** 볼드 미적용

CommonMark right-flanking delimiter rule — ) 뒤에 **가 오고 한국어가 이어지면 닫힘 인식 불가

<strong> 태그로 변환

수식이 빨간 코드 블록으로 렌더링

`x ≤ 0` 형태로 작성

$x ≤ 0$ 인라인 math로 변환

마크다운 미렌더링

source가 per-line list가 아닌 단일 문자열

per-line list 포맷 강제

툴

역할

add_cell(notebook_path, markdown, position)

셀 추가 — 위 3가지 수정 자동 적용

validate_notebook(notebook_path)

배포 전 검증 — 렌더링 이슈 사전 감지

update_toc(toc_path, chapter_index_file, section_files, parent_file)

_toc.yml 챕터/섹션 추가

deploy_and_wait(repo_path, commit_msg, wait_for_ci, timeout_seconds)

git add/commit/push + CI 결과 대기