[Github Pages] Notion to Github pages 변환 시의 주의사항

블로그 플랫폼을 Github pages로 결정한 데에는 markdown을 지원한다는 이유가 가장 컸다.

다른 블로그 플랫폼 또한 매력적인 기능들을 지원한다. 특히 개발자들이 많이 이용하는 tistory나 velog 같은 경우에는 블로그 커스터마이징과 글쓰기가 편하지만, 주로 사용하는 문서 작성 서비스가 Notion이기에 markdown을 지원하는 Github pages로 결정하였다.

따라서 Github pages의 게시물 작성 시에 Notion에서 작성한 글을 markdown 파일로 export 한 후에 해당 파일을 Github pages에 복사한다. 그러나 이 과정에서 Notion과 Github pages 간의 latex 엔진의 차이 때문인지 Notion에서 편집했던 형식이 Github pages에서는 깨지는 모습을 보였다.

따라서 이 글을 통해 Notion의 글을 Github pages에 올리는 과정에서 발생하는 오류와 그 해결방법을 정리하여 향후 게시물 관리를 원활히 하고자 한다.(Github pages를 사용함에 따라 발견되는 오류를 이 게시물에 계속하여 추가할 예정이다.)

1. latex 오류

1.1 - | 오류

Notion에서 정상적으로 출력된 결과

Github pages에서 오류가 발생한 결과

위 사진은 Notion에서는 잘 출력되던 latex 수식이 Github pages에서는 오류가 발생한 것을 보여준다. 해당 오류는 | 문자를 latex 수식에서 사용 시 발생하며, 해결 방법은 \mid 명령어를 사용하는 것이다.

아래와 같이 사용하면 된다.

- Conditional probability$P(A|B)$ : 사건 $B$가 일어났다는 조건 아래 사건 $A$의 확률

- Conditional probability $ P(A\mid B) $ : 사건 $ B $가 일어났다는 조건 아래 사건 $ A $의 확률

1.2 - \argmax 오류

Notion에서 정상적으로 출력된 결과

Github pages에서 오류가 발생한 결과

위 사진은 Notion에서는 잘 출력되던 latex 수식에 Github pages에서는 오류가 발생하는 것을 보여준다. 해당 오류는 \argmax 명령어를 latex 수식에서 그냥 사용 시 발생하며, 해결방법은 아래와 같이 latex 수식 시작 시에 \DeclareMathOperator*{\argmax}{arg\,max} 명령어를 작성해주면 된다. 이 명령어를 한 번만 작성해주면 이후 해당 게시물에서는 \argmax 를 오류 없이 사용할 수 있다. (물론 다른 게시물 작성 시에는 다시 작성해야 한다.)

아래와 같이 사용한다.

$$
\theta_{MLE} = \argmax\limits_{\theta}P(X|\theta)
$$

$$
\DeclareMathOperator*{\argmax}{arg\,max}
\theta_{MLE} = \argmax\limits_{\theta}P(X\mid \theta)
$$