My Thoughts on GitBook

GitBook은 참 좋은 서비스이다. Markdown이라 Notion과 호환도 좋고, 페이지도 깔끔해서 프레젠테이션도 괜찮다. 블로그는 날짜순으로 글이 정렬되어서 배운 것을 정리하기엔 블로그가 별로 적합하다고 생각하지 않는다.

배운 걸 모아두는 곳은 그래서 Notion, GitBook 같은 서비스가 블로그보다 더 뛰어나다고 생각한다.

Notion에 도메인을 연결하거나 oopy 등을 사용하는 법도 있지만 디자인이 더 마음에 들고 속도도 빨라서 GitBook을 쓰고 있다. GitHub repository와 연동해서 잔디를 채우기도 좋다.

근데 GitBook의 치명적인 단점이 몇 가지 있다.

• 한국어 지원이 너무 너무 끔찍하다. 이 정도일 수가 있나? 한국어로 작성하면 자꾸 블록의 첫 글자가 페이지의 맨 뒤로 보내진다. 그걸 지우면 가상의 글자로 인식되는 것인지 원래 있던 글자가 지워진다. 그래서 페이지를 나갔다 들어오거나, 맨 첫 글자를 공백으로 시작하고 글을 적은 뒤에 다시 돌아가서 공백을 삭제하거나, 영어로 적다가 한글로 쓰거나 하는 방법이 있는데... 할 때마다 인내심이 1씩 떨어진다. (지금은 적응했다.)

  • 
  • Notion도 이 정도는 아니다. 노션에서 한국어랑 이모지를 혼용하면 글자가 안적히는 버그가 있는데 그냥 페이지 나갔다 들어오거나 블록을 지우고 처음부터 다시 적으면 된다. 그리고 이모지 쓸 일이 얼마나 많다고...

  • 맥북에서만 그러는 게 아니라 윈도우에서도 동일한 문제가 발생한다.

  • 지금도 발견하는 대로 수정을 많이 거치고 있지만, 위의 사유 때문에 오타, 삭제된 글자나 알 수 없는 깨진 문자가 꽤 많이 보인다. 원래 오타를 자주 내는 성격이 아닌데 나름 보면서 수정한다고 해도 첫 글자마다 커서가 뒤로 보내지니까 일일히 신경쓰기가 어렵다.

  • 2018년에 이슈가 올라왔는데 아직도 해결이 안된 것 같다.

• 새로운 글을 publish 했을 때, 결과로 생성된 GitBook 사이트에 들어가서 안보이면 새로고침해야 보인다.

• 댓글 기능이 없다. 내가 운영하는 서비스가 아니라서 Disqus나 utterances를 달 수 있는 것도 아니다. 나 혼자 보려고 적는 글도 아닌데 솔직히 좀 아쉽다.

• GitHub과의 연동이 장점이라고 했는데, 이미지를 붙여넣으면 GitHub repository에 올라간다. 근데 이미지를 올린 뒤에 삭제하면 repository에 그대로 남아있다.

  • 같은 이미지 여러 개를 실수로 올렸다가 지워도 (1), (2), (3), ... 이런 식으로 다 남아있다. 그래도 삭제도 GitBook UI 내에서 지원하니까... 이건 너무 까고 싶진 않다.

  • 지금 올리면서 발견했는데 이미지를 블록 밑에 계층화시킬 수 없다. List 밑에 둘 때 노션은 자동으로 이미지가 작아지는데 여기는 bullet point(•)가 그대로 남아 있다.

  • 이미지 크기 조절이 안된다. (그나마 Notion과 달리 좌/우/가운데 정렬이 가능한 게 장점이긴 하다)

• 또 가끔 운 나쁘면 블록을 선택하고 싶은데 블록 클릭이 안되고 블록 밑에 + 버튼이 자꾸 눌려서 꽤 열 받는다.

• Unordered list와 ordered list를 섞어서 계층화 해서 쓸 때 노션은 1. 이렇게 적거나 - 이렇게 적으면 자동으로 변환되는데, GitBook에서는 그게 안되고 아래처럼 chocolate(:::) 버튼을 일일히 눌러야 된다. GitBook에서는 Notion에 익숙해져서 그런가? 불편하다.

  • 

혹평을 남기고 싶진 않았는데 적고 보니까 속이 좀 시원해졌다. 고쳐졌으면 좋겠는데 support가 그다지 활성화되지 않은 것 같기도 하고... 갈아탈 적당한 플랫폼이 있으면 갈아탈 것 같기도 하다.

갈아탈 플랫폼으로 알아둔 건 다음과 같다.

• Docusaurus (Self-hosted) - Facebook에서 개발. (CodeSandbox)

• Retype (Self-hosted)

Docusaurus를 테스트해보고, 괜찮으면 Docusaurus+GitHub Pages로 갈아탈 수도 있다. 다만 GitBook을 쓰는 이유가 글 작성 UI를 제공해주는 점도 있는데 이게 안된다면 아마도 meh.

(Edit on 2022-11-10) 갑자기 깃북 한글 작성이 너무 잘 된다. 이게 역시 제일 큰 문제였는지... 혹평은 일단 취소. 깃북 고마워요. 🙇‍♂️

(Edit on 2023-02-22) 이번엔 @를 이용한 게시글 링크 기능이 먹통이다. 정신 차려라 깃북 😭

링크가 안된다