지금은 맞고 그때는 틀리다 (기술 블로그 개편 여정)

문제 상황

• 2019년부터 사용한 Jekyll 기반 기술 블로그의 기능 부족과 커스터마이징 한계
• 개선·확장 요구를 기존 프레임워크에 누적할 때 커지는 공사 범위와 유지보수 부담

선택 이유

• 코드 스니펫, 마크다운 작성, 팀 적응성, 커스터마이징, 확장성을 기준으로 플랫폼 비교
• Medium의 코드 추가 불편과 GatsbyJS의 초기 학습 부담 고려
• 온라인 출판 콘텐츠에 최적화된 Docusaurus의 문서화 중심 특성 채택

해결 방법

• JavaScript·React 기반 Docusaurus로 기술 블로그 재구축
• 태그·키워드 페이지, 마크다운 기반 자동 목차, 다크 모드, 코드 복사 기능 활용
• @docusaurus/plugin-client-redirects의 fromExtensions: ['html'] 설정으로 Jekyll의 .html URL 리다이렉트 처리

적용해볼 점

• 블로그 플랫폼 선정 전 콘텐츠 작성 방식과 확장 요구를 우선순위로 명확화
• 기존 URL 규칙을 점검하고 리다이렉트 플러그인으로 검색·접근 경로 단절 방지