Citation Test Post

문제/맥락

기술 문서에서 인용 표시와 각주 출력은 플랫폼마다 다르게 처리된다. 자동 변환 도구나 정적 사이트 생성기는 인라인 표기법을 제거하거나 링크를 분리할 수 있어 재현성 있는 참조가 깨질 수 있다. 간단한 표식만 남겨도 독자가 출처를 확인할 수 있어야 하며, 표시 형식은 도구 체인에서 안정적으로 유지돼야 한다. 특히 학술 인용이나 법적 근거가 필요한 문서는 더 엄격한 관리가 필요하다^[1].

핵심 포인트

• 인라인 표기는 일관되게 유지하고, 각주는 문서 말미에 정의한다.

• DOI나 고유 식별자 사용으로 링크 유실을 보완할 것.

• 빌드 파이프라인에서 각주 렌더링을 자동 점검하는 스크립트를 추가하면 오류를 조기에 발견한다^[2]. 정기적으로 샘플 렌더링을 검토하라.

• 단순한 텍스트 참조와 메타데이터(저자, 연도, 식별자)를 함께 기록하면 재현성이 높아진다.

정리

각주와 인용은 가독성과 검증 가능성의 핵심이다. 플랫폼 특성을 고려해 표기 방법을 고정하고, 빌드 단계에서 렌더링을 확인하는 절차를 넣으면 참조 신뢰도를 높일 수 있다. 작은 습관이 문서의 품질을 좌우한다.