---
title: "[2026.10.29] GitHub KaTeX 수식 디버깅과 퀀타멘털 스윙 설계"
canonical_url: "https://wealth-podium.com/2026/10/29/build-log-day-02-katex-debugging-quantamental/"
published_at: "2026-10-29T18:00:00+09:00"
modified_at: "2026-11-07T15:44:36+09:00"
author: "Dellwon (Software Developer & System Architect)"
summary: "GitHub 웹 렌더러에서 마크다운 수식이 깨지던 원인을 역추적해 KaTeX 7대 원칙과 정규식 검증 스크립트로 자동화하고, 펀더멘털(CbOP)과 기술적 변동성 수축(PTH/VCP)을 결합한 퀀타멘털 스윙 알고리즘을 설계한 둘째 날의 기록입니다."
---
# [2026.10.29] GitHub KaTeX 수식 디버깅과 퀀타멘털 스윙 설계

> **엔지니어링 일지 요약**: GitHub 마크다운 파서와 KaTeX 간의 언더스코어(`_`) 충돌 현상을 디버깅하여 수식 표기 가이드라인을 확립하고, 재무 팩터와 기술적 모멘텀을 결합한 퀀타멘털 스윙 전략을 설계한 기록입니다.

---

## 1. 오늘의 주요 작업 및 설계 결정 (Key Decisions & Changes)

- **GitHub KaTeX 수식 렌더링 호환성 헌법 제정**:
  - 마크다운 파서가 수식 내부의 언더스코어(`_`)와 별표(`*`)를 이탤릭/볼드 태그로 오해하여 수식이 깨지는 현상 해결.
  - 규칙 1: 첨자 언더스코어는 반드시 `\_`로 이스케이프 처리.
  - 규칙 2: 수식 블록(`$$...$$`)의 전후에는 반드시 빈 줄을 삽입.
  - 규칙 3: 행렬/분수식 등 다중 연산 수식은 인라인 대신 독립 블록으로 분리.
- **퀀타멘털 스윙(Quantamental Swing) 2계층 필터링 설계**:
  - 단기 노이즈를 배제하고 실적 턴어라운드 종목을 포착하기 위해 펀더멘털과 모멘텀 결합:
    1. **1차 펀더멘털 스크리닝**: 영업이익 성장률 YoY > 20%, Piotroski F-Score >= 7점, 부채비율 < 150%.
    2. **2차 기술적 모멘텀 진입**: 주가 > 200일 SMA(장기 상승 추세), 20일 모멘텀 양수 전환, 14일 RSI 45~65(과열권 진입 전 눌림목).

---

## 2. 핵심 수식 및 파이프라인 (Formula & Pipeline)

```mermaid
flowchart LR
    A["전체 상장 종목 유니버스"] --> B["1차: 펀더멘털 필터<br/>(YoY 영업이익 > 20% & F-Score >= 7)"]
    B --> C["2차: 기술적 모멘텀 필터<br/>(주가 > 200 SMA & RSI 45~65)"]
    C --> D["최종 스윙 편입 포트폴리오<br/>(동일 비중 분산)"]
```

- **복합 팩터 점수화 수식**:
  $$Score_i = w_1 \cdot Z(Growth_{YoY}) + w_2 \cdot Z(F\_Score) + w_3 \cdot Z(Mom_{20D})$$

---

## 3. 트러블슈팅 & 기술 검증 (Troubleshooting & Verification)

- **발생 문제**: `quant-research` 보고서 내 복잡한 수식들이 GitHub 웹 UI에서 깨지거나 파싱 에러로 렌더링되지 않던 문제.
- **해결 조치**: 수식 검증 스크립트 작성 및 `\_` 이스케이프 헌법 일괄 적용 후 전수 검사 완료.
- **검증 결과**: GitHub 웹 UI 및 워드프레스 블로그 양쪽에서 모든 KaTeX 수식 100% 정상 렌더링 확인.

---

## 4. 완료 산출물 및 다음 단계 (Deliverables & Next Steps)

- **완료 산출물**:
  - `quant-research/docs/rules/katex-math-guide.md` (GitHub KaTeX 표기 헌법)
  - `quant-research/specs/02_quantamental_swing_spec.md` (퀀타멘털 스윙 전략 명세서)
- **다음 작업**: 5대 중장기 퀀트 전략 완주 및 3계층 저장소 아키텍처 연동.